GCE启动自动化脚本无法运行Spring Boot应用求助

问题描述 #

我在Google Cloud Compute Engine的Debian系统实例中托管Spring Boot Maven应用，已安装Maven。创建实例时在自动化启动框中添加了以下脚本：

cd spring-boot-app/
mvn clean package
cd target/
nohup java -jar artifact-1.0.jar &

使用nohup和&让应用后台运行，但停止再启动实例后，通过SSH执行ps ax | grep java看不到应用进程，需要排查问题原因。

排查与解决要点 #

• 脚本路径错误
  启动脚本默认以root用户执行，工作目录通常是/root或/，cd spring-boot-app/用的是相对路径，如果你的项目不在这个默认目录下，cd命令会直接失败，后续步骤都无法执行。
  解决：改用项目的绝对路径，比如你的项目在/home/your-user/spring-boot-app，修改脚本：

cd /home/your-user/spring-boot-app/

• Maven环境变量缺失
  启动脚本的执行环境和SSH登录后的用户环境不同，可能找不到mvn命令——SSH登录会加载用户的.bashrc或.profile配置，但系统启动脚本不会。
  解决：要么用mvn的绝对路径（通过SSH执行which mvn可获取，比如/usr/bin/mvn），要么在脚本开头加载用户环境变量：

source /home/your-user/.profile

• 无日志无法定位错误
  nohup默认输出到nohup.out，但如果工作目录不对或无写入权限，日志会丢失，你看不到执行过程中的错误。
  解决：在脚本里指定日志输出路径，同时捕获标准错误：

nohup java -jar artifact-1.0.jar > /var/log/spring-app.log 2>&1 &

后续可通过cat /var/log/spring-app.log查看启动日志，定位具体问题。

• 权限不足导致执行失败
  如果项目目录属于普通用户，而启动脚本以root执行，可能出现打包时无法写入target目录、运行时无法读取依赖等权限问题，导致进程启动后直接退出。
  解决：切换到项目所属的普通用户执行脚本，比如：

su - your-user -c "cd /home/your-user/spring-boot-app/ && mvn clean package && cd target/ && nohup java -jar artifact-1.0.jar > /var/log/spring-app.log 2>&1 &"

或者给启动用户分配项目目录的读写权限。

• 系统服务未就绪导致启动失败
  GCE启动脚本在系统启动早期执行，可能网络、数据库等依赖服务还未完全就绪，Spring Boot应用启动失败后直接退出，因此看不到进程。
  解决：在脚本中添加等待逻辑，确保依赖服务就绪后再启动应用，比如等待网络连通：

# 等待网络就绪
until ping -c1 google.com >/dev/null 2>&1; do sleep 1; done
# 执行打包和启动命令
cd /home/your-user/spring-boot-app/
mvn clean package
cd target/
nohup java -jar artifact-1.0.jar > /var/log/spring-app.log 2>&1 &

快速验证方法 #

SSH登录实例后，切换到启动脚本的执行用户（通常是root，执行sudo su），然后手动逐行运行脚本中的命令，观察哪一步出现报错，即可快速定位问题。

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