Shell命令在终端正常但Jenkins流水线无法启动服务的排查与解决

我之前也碰到过一模一样的Jenkins流水线启动后台服务失败的情况，结合你的脚本和Jenkins配置，把核心原因和解决办法整理如下：

核心原因 #

1. Jenkins的进程清理机制 #

Jenkins的sh步骤执行完毕后，会自动终止该步骤衍生的所有子进程——哪怕你用了nohup ... &让进程在终端后台运行，Jenkins的进程树管理也会在步骤结束后把这个后台进程杀掉，导致服务根本没真正启动起来。

2. 路径与权限问题 #

• 你的脚本里用了相对路径./logs/service-account.log，但Jenkins流水线的工作目录是它的Job专属workspace，如果这个目录下没有提前创建logs文件夹，nohup会因为无法写入日志文件直接启动失败。
• 另外，/data/jcpt/service/service-account/jar/这个路径如果Jenkins运行用户（比如默认的jenkins用户）没有读写权限，Java服务也会启动失败。

3. 环境变量差异 #

终端里的环境变量和Jenkins运行时的环境变量完全独立，比如终端里可能配置了SPRING_PROFILES_ACTIVE这类自定义变量，但Jenkins的环境里没有；不过你的脚本用了绝对路径的Java命令，这个问题影响不大，但还是要留意其他可能的变量缺失。

解决方案 #

方案1：让进程彻底脱离Jenkins进程控制 #

修改run.sh里的启动命令，用setsid把进程放到独立会话中，同时改用绝对路径写日志：

setsid nohup /usr/local/java/1.8/bin/java -Dspring.cloud.config.profile=test -Dspring.cloud.config.uri=http://localhost:8888/ -cp /data/jcpt/service/service-account/jar/.:/data/jcpt/service/service-account/jar/lib/* com.caifubao.jcpt.account.app.AccountApplication >/data/jcpt/service/service-account/logs/service-account.log 2>&1 < /dev/null &

或者用disown命令把进程从当前shell的作业列表移除：

nohup /usr/local/java/1.8/bin/java -Dspring.cloud.config.profile=test -Dspring.cloud.config.uri=http://localhost:8888/ -cp /data/jcpt/service/service-account/jar/.:/data/jcpt/service/service-account/jar/lib/* com.caifubao.jcpt.account.app.AccountApplication >/data/jcpt/service/service-account/logs/service-account.log 2>&1 < /dev/null &
disown

方案2：提前处理目录权限 #

在test.sh里先确保日志目录存在并给Jenkins用户授权：

#!/bin/bash
# 创建日志目录（不存在则创建）
mkdir -p /data/jcpt/service/service-account/logs
# 给Jenkins用户授权（假设Jenkins用户是jenkins）
chown -R jenkins:jenkins /data/jcpt/service/service-account/logs
# 启动服务
setsid nohup /usr/local/java/1.8/bin/java -Dspring.cloud.config.profile=test -Dspring.cloud.config.uri=http://localhost:8888/ -cp /data/jcpt/service/service-account/jar/.:/data/jcpt/service/service-account/jar/lib/* com.caifubao.jcpt.account.app.AccountApplication >/data/jcpt/service/service-account/logs/service-account.log 2>&1 < /dev/null &

方案3：临时禁用Jenkins进程清理 #

在Jenkins流水线里添加环境变量，告诉Jenkins不要杀掉当前步骤的后台进程：

stage('UPLOAD') { 
    agent{node { label "TEST" }} 
    steps { 
        withEnv(['BUILD_ID=dontKillMe']) {
            sh "./test.sh"
        }
    } 
}

⚠️ 注意：这种方式不推荐长期使用，容易导致Jenkins节点残留大量僵尸进程，适合临时调试。

验证方法 #

启动后可以在Jenkins节点上执行ps -ef | grep AccountApplication查看进程是否存在，或者直接查看日志文件/data/jcpt/service/service-account/logs/service-account.log，从日志里排查具体的启动错误。

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