CentOS 7下Jenkins从2.176.1升级至2.375.2失败求助

核心排查与修复步骤 #

1. 优先通过日志定位错误 #

日志是定位问题的核心依据，执行以下命令获取关键日志信息：

# 查看Jenkins应用日志
tail -n 100 /var/log/jenkins/jenkins.log
# 查看系统服务层面的Jenkins日志
journalctl -u jenkins.service --since "15 minutes ago"

重点关注日志中的ERROR、Exception类提示，比如Java版本不兼容、插件加载失败、文件权限不足等信息。

2. 检查Java版本兼容性 #

Jenkins 2.375.2 要求使用 Java 11 或 Java 17，而2.176.1支持Java 8，这是升级失败的高频原因：

# 检查当前Java版本
java -version

如果输出为Java 8，执行以下步骤升级：

# 安装OpenJDK 11
yum install java-11-openjdk-devel -y
# 选择Java 11作为默认版本（输入对应序号回车）
alternatives --config java
# 验证设置是否生效
java -version

同时修改Jenkins配置文件指定Java路径：

vi /etc/sysconfig/jenkins
# 修改以下配置项：
JENKINS_JAVA_CMD="/usr/lib/jvm/java-11-openjdk/bin/java"

3. 处理插件兼容性问题 #

旧版本插件大概率与新版本Jenkins不兼容，分两种场景处理：

• 未完成升级操作：先在2.176.1版本中，进入「Manage Jenkins」→「Manage Plugins」升级所有插件到最新兼容版本，再执行Jenkins升级。
• 已替换war包/完成yum升级：跳过插件检查启动Jenkins，排查问题插件：

systemctl stop jenkins
# 跳过插件启动Jenkins
java -jar /usr/lib/jenkins/jenkins.war --disable-plugins

若能正常启动，再逐步启用插件；也可备份后删除旧插件目录，重新安装兼容插件：

mv /var/lib/jenkins/plugins /var/lib/jenkins/plugins_backup
systemctl start jenkins

4. 修复文件权限问题 #

替换war包后易出现权限错误，执行以下命令修正：

# 设置jenkins.war文件权限
chown jenkins:jenkins /usr/lib/jenkins/jenkins.war
chmod 644 /usr/lib/jenkins/jenkins.war
# 确保Jenkins数据目录权限正确
chown -R jenkins:jenkins /var/lib/jenkins/

5. 验证RPM包完整性（yum升级场景） #

若yum升级无报错但启动失败，可能是包损坏，重新安装：

yum reinstall jenkins -y
systemctl start jenkins

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