在Jenkins的持续集成流程中，运行独立JAR文件是常见的需求，比如部署Spring Boot应用、执行定时任务程序等，不同的场景可以选择不同的实现方式，同时需要做好参数和配套配置才能保证运行稳定。
一、Jenkins中运行独立JAR文件的常用方法
1. 直接在构建步骤中执行Java命令
这种方式适合简单的运行场景，不需要额外编写脚本，直接在Jenkins的构建步骤中添加执行命令即可。首先需要在Jenkins所在服务器上安装好JDK，并且配置好JAVA_HOME环境变量。
操作步骤：进入Jenkins任务配置页面，在构建区域点击增加构建步骤，选择执行shell（Linux环境）或者执行Windows批处理命令（Windows环境），然后输入运行JAR的命令。
Linux环境下的示例代码：
# 运行当前目录下的demo.jar，指定JVM最大堆内存为512M，传递程序参数arg1和arg2 java -Xmx512m -jar /opt/jenkins_workspace/demo.jar arg1 arg2
Windows环境下的示例代码：
# 运行D盘jenkins工作空间下的demo.jar，指定JVM初始堆内存为256M java -Xms256m -jar D:jenkins_workspacedemo.jar
2. 通过Shell脚本执行JAR文件
当运行逻辑比较复杂，比如需要先停止旧进程、备份旧文件、再启动新JAR时，直接写命令会很长且不好维护，这时候可以编写Shell脚本，让Jenkins调用脚本执行。
首先编写启动脚本start_jar.sh，内容如下：
#!/bin/bash
# 定义JAR文件路径
JAR_PATH=/opt/jenkins_workspace/app.jar
# 定义日志输出路径
LOG_PATH=/opt/jenkins_workspace/app.log
# 定义进程关键词，用于查找旧进程
PROCESS_KEY=app.jar
# 停止旧进程
pid=$(ps -ef | grep $PROCESS_KEY | grep -v grep | awk '{print $2}')
if [ -n "$pid" ]; then
echo "停止旧进程，pid为$pid"
kill -9 $pid
fi
# 启动新的JAR进程，后台运行，日志输出到指定文件
nohup java -Xmx1024m -jar $JAR_PATH --spring.profiles.active=prod >> $LOG_PATH 2>&1 &
echo "JAR文件启动成功，日志输出到$LOG_PATH"
然后在Jenkins的构建步骤中执行这个脚本即可：
# 给脚本添加执行权限并执行 chmod +x /opt/scripts/start_jar.sh /opt/scripts/start_jar.sh
二、运行参数配置说明
1. JVM参数配置
JVM参数用于调整Java虚拟机的运行性能，常用的参数如下：
-Xms：设置JVM初始堆内存大小，比如-Xms256m表示初始堆内存256M-Xmx：设置JVM最大堆内存大小，比如-Xmx1024m表示最大堆内存1024M-XX:MetaspaceSize：设置元空间初始大小，避免元空间频繁扩容-XX:MaxMetaspaceSize：设置元空间最大大小
示例配置：
# 配置JVM初始堆256M，最大堆1024M，元空间最大256M java -Xms256m -Xmx1024m -XX:MaxMetaspaceSize=256m -jar app.jar
2. 程序运行参数配置
程序运行参数是传递给JAR内部程序的参数，不同框架的参数格式不同，比如Spring Boot应用常用--参数名=参数值的格式，普通Java程序可以用空格分隔参数。
Spring Boot应用参数示例：
# 指定运行环境为测试环境，服务端口为8081 java -jar app.jar --spring.profiles.active=test --server.port=8081
普通Java程序参数示例：
# 传递三个参数，程序内可以通过args数组获取 java -jar app.jar 参数1 参数2 参数3
三、常见配置问题与解决方案
1. JAR文件后台运行配置
如果直接在Jenkins构建步骤中执行java -jar命令，当Jenkins构建任务结束后，进程可能会被杀死，导致JAR无法持续运行。这时候需要使用nohup命令让进程后台运行，并且忽略挂断信号。
正确配置示例：
# nohup保证进程后台运行，&让命令立即返回，日志输出到app.log nohup java -jar app.jar >> app.log 2>&1 &
2. 权限问题处理
如果Jenkins运行时提示没有权限执行JAR文件或者脚本，需要检查对应文件的权限，给Jenkins运行的用户（通常是jenkins用户）添加执行权限：
# 给JAR文件添加执行权限 chmod +x /opt/jenkins_workspace/app.jar # 给脚本添加执行权限 chmod +x /opt/scripts/start_jar.sh
3. 环境变量配置
如果Jenkins执行时提示java: command not found，说明Jenkins没有找到Java可执行文件路径，需要在Jenkins全局配置中配置JDK路径，或者在执行命令前先加载环境变量：
# 先加载环境变量，再执行Java命令 source /etc/profile java -jar app.jar
四、配置检查与验证
配置完成后，可以执行以下操作验证JAR是否正常运行：
- 查看进程是否存在：
ps -ef | grep app.jar | grep -v grep - 查看日志文件是否有新的输出：
tail -f app.log - 如果是Web应用，访问对应的服务端口验证接口是否正常响应
如果运行出现异常，可以查看Jenkins的构建日志和JAR的输出日志，定位参数错误、路径错误或者权限问题。通过合理的参数和配置，就能让Jenkins稳定地运行独立JAR文件，满足持续集成和部署的需求。
Jenkins独立JAR文件Java参数配置Jenkins构建任务Shell脚本修改时间：2026-06-27 22:45:37