Jenkins构建完，jar包启动不起来？

简介

Jenkins 是一款自动化部署项目的工具，可通过可视化的管理界面，实现对项目的构建部署。

本文介绍一次构建完工程，执行运行脚本后，项目起不来的问题。

场景

启动项目的脚本如下，很普通的启动脚本。

#!/bin/bash

APP_NAME="no_database_demo-1.0-SNAPSHOT"
JAR_PATH="/root/.jenkins/workspace/no_database_demo/target/${APP_NAME}.jar"
LOG_PATH="/var/log/${APP_NAME}.log"
PID_FILE="/var/run/${APP_NAME}.pid"  # 新增：定义PID文件路径
JAVA_CMD="/usr/local/dev/jdk-21.0.5/bin/java"

# --- 核心：通过PID文件杀死旧实例 ---
echo "正在停止所有旧的 $APP_NAME 进程..."
if [ -f "$PID_FILE" ]; then
    OLD_PID=$(cat "$PID_FILE")
    if ps -p $OLD_PID > /dev/null; then
        echo "停止进程 $OLD_PID..."
        kill $OLD_PID
        sleep 3
        if ps -p $OLD_PID > /dev/null; then
            kill -9 $OLD_PID
        fi
    fi
    rm -f $PID_FILE
fi

# --- 启动新进程并写入PID文件 ---
echo "启动 $APP_NAME..."
nohup "$JAVA_CMD" -jar "$JAR_PATH" > "$LOG_PATH" 2>&1 &
NEW_PID=$!
echo $NEW_PID > $PID_FILE
echo "启动成功，PID: $NEW_PID"

Jenkins 中点击立即构建后，确定是执行了这个脚本，因为控制台打印了 “启动成功，PID：XXX” 日志。

但是回到服务器，使用 jps 命令就是看不到运行中的 Java 程序。

更可恶的是，如果此时在服务器里手动执行这个脚本，jar 包就能被启动起来。

解决

最终排查是因为 Jenkins 在构建完一个工程后，会将所有相关的子进程杀死，我这个 jar 进程刚启动就被 Jenkins 杀死了。

需要在执行脚本开头加一行 “宇宙安全声明”。

# 禁用 Jenkins 进程收割
export BUILD_ID=dontKillMe

修改后如下：

#!/bin/bash

# 禁用 Jenkins 进程收割
export BUILD_ID=dontKillMe

APP_NAME="no_database_demo-1.0-SNAPSHOT"
JAR_PATH="/root/.jenkins/workspace/no_database_demo/target/${APP_NAME}.jar"
LOG_PATH="/var/log/${APP_NAME}.log"
PID_FILE="/var/run/${APP_NAME}.pid"  # 新增：定义PID文件路径
JAVA_CMD="/usr/local/dev/jdk-21.0.5/bin/java"

# --- 核心：通过PID文件杀死旧实例 ---
echo "正在停止所有旧的 $APP_NAME 进程..."
if [ -f "$PID_FILE" ]; then
    OLD_PID=$(cat "$PID_FILE")
    if ps -p $OLD_PID > /dev/null; then
        echo "停止进程 $OLD_PID..."
        kill $OLD_PID
        sleep 3
        if ps -p $OLD_PID > /dev/null; then
            kill -9 $OLD_PID
        fi
    fi
    rm -f $PID_FILE  # 删除旧PID文件
fi

# --- 启动新进程并写入PID文件 ---
echo "启动 $APP_NAME..."
nohup "$JAVA_CMD" -jar "$JAR_PATH" > "$LOG_PATH" 2>&1 &
NEW_PID=$!
echo $NEW_PID > $PID_FILE  # 写入新PID到文件
echo "启动成功，PID: $NEW_PID"