feature: add GraalVM native image build support for seata-server

.gitignore

@@ -88,3 +88,5 @@ Thumbs.db
 /console/src/main/resources/static/saga-statemachine-designer/
 /console/src/main/resources/static/index.html
 /console/src/main/resources/static/version.json
+
+__pycache__/

Makefile

@@ -23,14 +23,26 @@ SHELL := /usr/bin/env bash
 # matching the target name — make will always execute them regardless of file timestamps)
 .PHONY: help clean spotless-check spotless-apply checkstyle checkstyle-diff license test \
 	package-only package \
-	install-server-jar install-namingserver-jar \
-	install-run-namingserver-native-jar run-namingserver-native-jar \
-	install-run-server-jar run-server-jar \
-	install-run-server-jar-registry-seata run-server-jar-registry-seata \
+	install-server-jar \
+	install-namingserver-jar \
+	install-run-namingserver-native-jar \
+	run-namingserver-native-jar \
+	install-run-server-native-file-jar \
+	run-server-native-file-jar \
+	install-run-server-jar \
+	run-server-jar \
+	install-run-server-jar-registry-seata \
+	run-server-jar-registry-seata \
 	test-native-namingserver \
+	test-native-server \
 	run-merge-native-namingserver \
-	install-namingserver-native package-namingserver-native \
-	run-namingserver-native
+	install-namingserver-native \
+	package-namingserver-native \
+	run-namingserver-native \
+	install-server-native \
+	package-server-native \
+	run-server-native-file \
+	run-server-native-nacos
 
 help: ## Show help information
 	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "\033[36m%-34s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
@@ -45,16 +57,52 @@ MVN ?= $(shell command -v mvn >/dev/null 2>&1 && echo "mvn" || echo "./mvnw")
 MAVEN_ARGS ?= -T 4C -e -B -V
 
 NACOS_SERVER_ADDR ?= 127.0.0.1:8848
+NACOS_NAMESPACE ?=
+NACOS_GROUP ?= SEATA_GROUP
+NACOS_DATAID ?= seataServer.properties
+NACOS_USERNAME ?=
+NACOS_PASSWORD ?=
 
-# Dynamically resolve the namingserver version from the Maven project (e.g. 2.8.0-SNAPSHOT)
+# Shared Nacos environment variables for config (nacos) + registry (nacos) + store (file) mode
+define NACOS_MODE_ENV
+SEATA_CONFIG_TYPE=nacos \
+SEATA_CONFIG_NACOS_SERVERADDR=$(NACOS_SERVER_ADDR) \
+SEATA_CONFIG_NACOS_NAMESPACE=$(NACOS_NAMESPACE) \
+SEATA_CONFIG_NACOS_GROUP=$(NACOS_GROUP) \
+SEATA_CONFIG_NACOS_CONTEXTPATH= \
+SEATA_CONFIG_NACOS_USERNAME=$(NACOS_USERNAME) \
+SEATA_CONFIG_NACOS_PASSWORD=$(NACOS_PASSWORD) \
+SEATA_CONFIG_NACOS_ACCESSKEY= \
+SEATA_CONFIG_NACOS_SECRETKEY= \
+SEATA_CONFIG_NACOS_RAMROLENAME= \
+SEATA_CONFIG_NACOS_DATAID=$(NACOS_DATAID) \
+SEATA_REGISTRY_TYPE=nacos \
+SEATA_REGISTRY_PREFERREDNETWORKS=30.240.* \
+SEATA_REGISTRY_IGNOREDINTERFACES=VMware.* \
+SEATA_REGISTRY_METADATA_WEIGHT=100 \
+SEATA_REGISTRY_NACOS_APPLICATION=seata-server \
+SEATA_REGISTRY_NACOS_SERVERADDR=$(NACOS_SERVER_ADDR) \
+SEATA_REGISTRY_NACOS_NAMESPACE=$(NACOS_NAMESPACE) \
+SEATA_REGISTRY_NACOS_GROUP=$(NACOS_GROUP) \
+SEATA_REGISTRY_NACOS_CLUSTER=default \
+SEATA_REGISTRY_NACOS_CONTEXTPATH= \
+SEATA_REGISTRY_NACOS_USERNAME=$(NACOS_USERNAME) \
+SEATA_REGISTRY_NACOS_PASSWORD=$(NACOS_PASSWORD) \
+SEATA_REGISTRY_NACOS_ACCESSKEY= \
+SEATA_REGISTRY_NACOS_SECRETKEY= \
+SEATA_REGISTRY_NACOS_RAMROLENAME= \
+SEATA_STORE_TYPE=file
+endef
+
+# Dynamically resolve the namingserver/server version from the Maven project (e.g. 2.8.0-SNAPSHOT)
 SERVER_VERSION ?= $(shell $(MVN) help:evaluate -Dexpression=project.version -q -DforceStdout)
-NATIVE_PLATFORM=$(shell $(MVN) help:evaluate -Dexpression=native.platform -q -DforceStdout)
+NATIVE_PLATFORM ?= $(shell $(MVN) help:evaluate -Dexpression=native.platform -q -DforceStdout)
 
 clean: ## Clean the project
 	$(MVN) $(MAVEN_ARGS) clean
 
 spotless-check: ## Run Spotless code format check
-	$(MVN) $(MAVEN_ARGS) spotless:check -Ptest-native-metadata-merge -Ptest-native-namingserver
+	$(MVN) $(MAVEN_ARGS) spotless:check -Ptest-native-metadata-merge -Ptest-native-namingserver -Ptest-native-server
 
 spotless-apply: ## Apply Spotless code formatting
 	$(MVN) $(MAVEN_ARGS) spotless:apply -Ptest-native-metadata-merge -Ptest-native-namingserver
@@ -118,6 +166,32 @@ run-namingserver-native-jar: ## Run namingserver with GraalVM native-image agent
 	@echo "     make run-merge-native-namingserver"
 	${GRAALVM_HOME}/bin/java -agentlib:native-image-agent=config-output-dir=./target/native-image-config -jar ./namingserver/target/seata-namingserver.jar --console.user.username=seata  --console.user.password=seata
 
+install-run-server-native-file-jar: install-server-jar ## Build, install, and run server with GraalVM native-image agent
+	@$(MAKE) --no-print-directory run-server-native-file-jar
+
+run-server-native-file-jar: ## Run server with GraalVM native-image agent (without prior build/install)
+	@echo "=== Workload steps (run in separate terminals) ==="
+	@echo "1. Start server in seata registry mode connecting to server:"
+	@echo "     make install-run-server-jar-registry-seata"
+	@echo "     or"
+	@echo "     make run-server-jar-registry-seata"
+	@echo "2. Run the native server test suite:"
+	@echo "     make test-native-server"
+	@echo "3. After tests pass, stop this server (Ctrl+C) so the agent flushes metadata,"
+	@echo "   then merge the collected metadata:"
+	@echo "     make run-merge-native-server"
+	SEATA_CONFIG_TYPE=file \
+	SEATA_REGISTRY_TYPE=file \
+	SEATA_STORE_TYPE=file \
+	${GRAALVM_HOME}/bin/java -agentlib:native-image-agent=config-output-dir=./target/native-image-config -jar ./server/target/seata-server.jar
+
+install-run-server-native-nacos-jar: install-server-jar ## Build, install, and run server with GraalVM native-image agent
+	@$(MAKE) --no-print-directory run-server-native-nacos-jar
+
+run-server-native-nacos-jar: ## Run server with GraalVM native-image agent (without prior build/install)
+	$(NACOS_MODE_ENV) \
+	${GRAALVM_HOME}/bin/java -agentlib:native-image-agent=config-output-dir=./target/native-image-config -jar ./server/target/seata-server.jar
+
 install-run-server-jar: install-server-jar ## Build, install, and run the server JAR
 	@$(MAKE) --no-print-directory run-server-jar
 
@@ -137,10 +211,17 @@ run-server-jar-registry-seata: ## Run the server JAR (without prior build/instal
 test-native-namingserver: ## Run namingserver GraalVM native-image compatibility tests (requires GraalVM with native-image)
 	$(MVN) $(MAVEN_ARGS) clean test -Ptest-native-namingserver -pl test-suite/test-native-namingserver
 
+test-native-server:
+	$(MVN) $(MAVEN_ARGS) clean test -Ptest-native-server -pl test-suite/test-native-server
+
 run-merge-native-namingserver: ## Merge collected native-image metadata into the namingserver resource directory (required to regenerate native metadata)
 	EXECUTE_NATIVE_METADATA_MERGE_NAMINGSERVER=true \
 	$(MVN) $(MAVEN_ARGS) clean test -Dtest=ExecuteMergeNativeImageMetadataTests#namingServer -pl test-suite/test-native-metadata-merge -Ptest-native-metadata-merge
 
+run-merge-native-server: ## Merge collected native-image metadata into the server resource directory (required to regenerate native metadata)
+	EXECUTE_NATIVE_METADATA_MERGE_SERVER=true \
+	$(MVN) $(MAVEN_ARGS) clean test -Dtest=ExecuteMergeNativeImageMetadataTests#server -pl test-suite/test-native-metadata-merge -Ptest-native-metadata-merge
+
 install-namingserver-native: install-namingserver-jar ## Build namingserver GraalVM native image (requires install-namingserver-jar including its spotless-apply dependency)
 	@$(MAKE) --no-print-directory package-namingserver-native
 
@@ -158,3 +239,33 @@ run-namingserver-native: ## Run the namingserver native image binary directly
 	CONSOLE_USER_USERNAME=seata \
 	CONSOLE_USER_PASSWORD=seata \
 	./namingserver/target/seata-namingserver-$(SERVER_VERSION)-$(NATIVE_PLATFORM)
+
+install-server-native: install-server-jar ## Build server GraalVM native image (requires install-server-jar including its spotless-apply dependency)
+	@$(MAKE) --no-print-directory package-server-native
+
+package-server-native: spotless-apply ## Build server GraalVM native image (requires install-server-native or install-server-jar to be executed first; spotless-apply runs first as a direct prerequisite)
+	$(MVN) $(MAVEN_ARGS) clean package -DskipTests -pl server spring-boot:process-aot -Pnative native:compile
+
+run-server-native-file: ## Run the server native image binary directly
+	@echo "=== Workload steps (run in separate terminals) ==="
+	@echo "1. Start server in seata registry mode connecting to server:"
+	@echo "     make install-run-server-jar-registry-seata"
+	@echo "     or"
+	@echo "     make run-server-jar-registry-seata"
+	@echo "2. Run the native server test suite:"
+	@echo "     make test-native-server"
+	SEATA_CONFIG_TYPE=file \
+	SEATA_REGISTRY_TYPE=file \
+	SEATA_STORE_TYPE=file \
+	./server/target/seata-server-$(SERVER_VERSION)-$(NATIVE_PLATFORM)
+
+run-server-native-nacos: ## Run the server native image binary directly
+	@echo "=== Workload steps (run in separate terminals) ==="
+	@echo "1. Start server in seata registry mode connecting to server:"
+	@echo "     make install-run-server-jar-registry-seata"
+	@echo "     or"
+	@echo "     make run-server-jar-registry-seata"
+	@echo "2. Run the native server test suite:"
+	@echo "     make test-native-server"
+	$(NACOS_MODE_ENV) \
+	./server/target/seata-server-$(SERVER_VERSION)-$(NATIVE_PLATFORM)

changes/en-us/2.x.md

@@ -21,6 +21,7 @@ Add changes here for all PR submitted to the 2.x branch.
 ### feature:
 
 - [[#8165](https://github.com/apache/incubator-seata/pull/8165)]/[[#8200](https://github.com/apache/incubator-seata/pull/8200)] add GraalVM native image build support for seata-namingserver
+- [[#8162](https://github.com/apache/incubator-seata/pull/8162)] add GraalVM native image build support for seata-server
 - [[#8140](https://github.com/apache/incubator-seata/pull/8140)] support automatic updated marking after BusinessActionContext modifications
 - [[#8188](https://github.com/apache/incubator-seata/pull/8188)] support action status report and TccHook rollback interceptors in Saga annotation mode for anti-suspension and empty rollback
 

changes/zh-cn/2.x.md

@@ -21,6 +21,7 @@
 ### feature:
 
 - [[#8165](https://github.com/apache/incubator-seata/pull/8165)]/[[#8200](https://github.com/apache/incubator-seata/pull/8200)] 为 seata-namingserver 添加 GraalVM 原生镜像构建支持
+- [[#8162](https://github.com/apache/incubator-seata/pull/8162)] 为 seata-server 添加 GraalVM 原生镜像构建支持
 - [[#8140](https://github.com/apache/incubator-seata/pull/8140)] 支持在 BusinessActionContext 变更后自动标记 updated
 - [[#8188](https://github.com/apache/incubator-seata/pull/8188)] Saga 注解模式支持 action status 上报和 TccHook 回滚切面，增强防悬挂和空回滚能力
 

dependencies/pom.xml

@@ -83,7 +83,7 @@
         <hessian.version>4.0.63</hessian.version>
         <fastjson2.version>2.0.52</fastjson2.version>
         <groovy.version>4.0.31</groovy.version>
-        <zstd.version>1.5.0-4</zstd.version>
+        <zstd.version>1.5.7-3</zstd.version>
         <jackson.version>2.18.3</jackson.version>
         <jackson3.version>3.1.1</jackson3.version>
         <xstream.version>1.4.21</xstream.version>

distribution/release-seata.xml

@@ -165,9 +165,13 @@
             <outputDirectory>seata-server/conf/</outputDirectory>
         </file>
 
+        <!-- Use logback-spring-jvm.xml (with &lt;if&gt; conditional for external conf support)
+             as the distribution config, renamed to logback-spring.xml so the existing
+             launch script (-Dlogging.config=.../conf/logback-spring.xml) picks it up. -->
         <file>
-            <source>../server/src/main/resources/logback-spring.xml</source>
+            <source>../server/src/main/resources/logback-spring-jvm.xml</source>
             <outputDirectory>seata-server/conf/</outputDirectory>
+            <destName>logback-spring.xml</destName>
         </file>
 
         <file>

pom.xml

@@ -395,6 +395,12 @@
         </profile>
 
         <!-- profile: native -->
+        <profile>
+            <id>test-native-server</id>
+            <modules>
+                <module>test-suite/test-native-server</module>
+            </modules>
+        </profile>
         <profile>
             <id>test-native-namingserver</id>
             <modules>