Spring Boot Webflux GraphQL应用Jar包部署流程咨询

首先明确核心前提：WebFlux基于Reactive Streams规范做非阻塞请求处理，独立部署的Tomcat是Servlet阻塞模型，把应用打成War包丢进去运行会走Servlet 3.1异步适配层，不仅会损失非阻塞特性，长连接、SSE等响应式能力也可能出现兼容问题，官方推荐的生产部署方案就是直接运行内嵌Netty容器的可执行Jar，能完整保留所有WebFlux特性。

一、打包前配置检查 #

• 依赖校验：确保项目中只引入了spring-boot-starter-webflux作为Web层依赖，GraphQL层用官方的spring-boot-starter-graphql即可，不要混入spring-boot-starter-web、spring-boot-starter-tomcat这类Servlet相关依赖；如果之前为了War包部署写过继承SpringBootServletInitializer的启动类，直接删除即可。
• 打包插件校验：Maven项目确认pom.xml中配置了spring-boot-maven-plugin，Gradle项目确认引入了org.springframework.boot插件，不需要额外配置War包相关参数。
• 生产配置预调整：提前在生产配置文件（application-prod.yml/properties）里配好Netty工作线程数、GraphQL查询超时时间、最大查询深度、数据源连接池等参数，不要沿用开发环境的默认配置。

二、执行打包操作 #

• 进入项目根目录，执行对应构建命令：
  • Maven项目：mvn clean package -DskipTests
  • Gradle项目：./gradlew bootJar -x test
• 打包完成后去对应目录找产物：
  • Maven项目产物在target目录下，Gradle项目产物在build/libs目录下
  • 选择体积较大（通常几十MB）、文件名不带.original后缀的Jar包，这个就是内嵌了Netty容器、包含所有依赖的可执行Jar；体积只有几MB的.original后缀文件是未打包依赖的普通Jar，无法直接运行。

三、服务器部署运行 #

• 服务器环境准备：提前安装对应版本的JDK，Spring Boot 3.x版本必须用JDK17及以上，Spring Boot 2.x版本用JDK8及以上即可，配置好JAVA_HOME环境变量，执行java -version能正常返回版本信息就符合要求。
• 上传Jar包：把本地打包好的可执行Jar上传到服务器指定部署目录，比如/opt/apps/graphql-demo/，提前在目录下建好logs文件夹存日志。
• 生产启动命令：不要直接用裸的java -jar命令启动，建议搭配JVM参数、环境配置、后台运行参数，参考命令如下：

nohup java -Xms512m -Xmx2048m -XX:+UseG1GC -Dspring.profiles.active=prod -jar /opt/apps/graphql-demo/your-app-name.jar > /opt/apps/graphql-demo/logs/app.log 2>&1 &

参数说明：

• nohup和命令末尾的&表示让应用后台运行，关闭SSH连接后进程不会退出
• -Xms/-Xmx配置JVM初始堆内存和最大堆内存，根据服务器配置调整即可
• -XX:+UseG1GC指定G1垃圾回收器，更适配WebFlux低延迟的响应式场景
• -Dspring.profiles.active=prod指定激活生产环境配置
• 末尾的重定向规则是把控制台日志全部输出到指定日志文件，方便排查问题
• 启动校验：执行ps -ef | grep 你的Jar包名查看进程是否存在，也可以查看日志文件里的Netty启动日志，确认端口监听正常后，给/graphql端点发个简单的测试查询请求，验证服务可用即可。

四、生产优化建议 #

• 建议用Systemd把应用配置成系统服务，配置开机自启、异常自动重启策略，比单纯nohup启动更稳定，也方便统一管理启动、停止、重启操作。
• 如果需要在应用前加Nginx做反向代理，尽量选1.19以上版本，关闭代理缓冲配置，避免影响WebFlux的长连接、响应式流推送特性。
• 不要尝试把可执行Jar或者War包丢到独立Tomcat、Jetty等Servlet容器中运行，会自动切换到Servlet适配模式，彻底丢失WebFlux的非阻塞特性。

内容的提问来源于stack exchange，提问作者Durgesh