插件更新后Jenkins无法启动的故障排查求助

1. 检查Jenkins系统服务配置 #

首先查看Jenkins的systemd服务文件，通常路径是/lib/systemd/system/jenkins.service或者/etc/systemd/system/jenkins.service：

sudo cat /lib/systemd/system/jenkins.service

找到ExecStart这一行，正常格式应该类似：

ExecStart=/usr/bin/jenkins --webroot=/var/cache/jenkins/war --httpPort=$HTTP_PORT --prefix=$PREFIX

如果这一行末尾多了self这个无效参数，直接删掉，保存文件后执行：

sudo systemctl daemon-reload
sudo systemctl start jenkins

2. 检查Jenkins全局配置文件 #

打开/etc/default/jenkins配置文件：

sudo nano /etc/default/jenkins

查找JAVA_OPTS或JENKINS_JAVA_OPTIONS这两个环境变量，看是否误添加了self内容（比如写成JAVA_OPTS="-Xmx1024m self"）。删掉多余的self，保存后重启服务：

sudo systemctl restart jenkins

3. 不要直接执行/usr/bin/jenkins #

直接运行/usr/bin/jenkins会使用当前用户权限，且不会加载systemd服务中定义的运行用户、JENKINS_HOME等配置，所以必须通过systemctl命令管理Jenkins服务，确保运行环境正确。

4. 排查插件升级导致的配置损坏 #

如果以上步骤都无效，可能是插件升级破坏了Jenkins配置：

• 先备份Jenkins主目录：

sudo cp -r /var/lib/jenkins /var/lib/jenkins.bak

• 重命名插件目录，临时禁用所有插件：

sudo mv /var/lib/jenkins/plugins /var/lib/jenkins/plugins.bak

• 尝试启动Jenkins：

sudo systemctl start jenkins

如果能正常启动，再逐个将plugins.bak里的插件移回plugins目录，每次移完重启Jenkins，找出导致问题的插件并移除或重新安装。

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