更新Jenkins插件后服务无法启动，报错状态码5/NOTINSTALLED与1/FAILURE

错误原因分析 #

• status=5/NOTINSTALLED：核心原因是Jenkins无法识别或加载更新后的插件，常见场景包括插件与Jenkins核心版本不兼容、插件更新过程中文件损坏、Jenkins用户无插件目录读写权限。
• status=1/FAILURE：属于通用启动失败状态，多由插件冲突、插件代码触发初始化异常、配置文件损坏导致Jenkins启动流程中断。

故障排查切入点 #

• 优先查看启动日志定位具体问题
  执行journalctl -u jenkins.service -f实时追踪系统层面的Jenkins启动日志，或者直接查看Jenkins主目录下的logs/jenkins.log文件，日志中会包含插件加载失败、类缺失、配置错误等关键堆栈信息，是定位问题的核心依据。
• 回滚插件验证故障来源
  1. 进入Jenkins插件默认目录/var/lib/jenkins/plugins，找到刚更新的三款插件对应的.hpi文件，将其重命名（例如添加.bak后缀）或删除。
  2. 执行systemctl restart jenkins尝试重启，若能正常启动，则逐个恢复插件并重启，确认是哪款插件引发的问题。
• 核对插件与Jenkins核心兼容性
  查看插件的MANIFEST.MF文件（可直接解压.hpi文件查看），其中的Jenkins-Version字段标注了该插件要求的最低Jenkins核心版本，确认当前Jenkins核心版本是否满足要求。
• 修复文件权限问题
  执行chown -R jenkins:jenkins /var/lib/jenkins，确保Jenkins运行用户对主目录及插件目录拥有完整的读写权限，避免因权限不足导致插件无法加载。
• 验证配置文件完整性
  备份Jenkins主目录下的config.xml，然后替换为备份的旧版配置文件（或删除自定义配置节点），尝试启动Jenkins，排查是否因配置文件损坏引发启动失败。
• 排查插件依赖缺失
  如果日志提示特定类或依赖插件不存在，需根据报错信息安装对应依赖插件，或调整插件版本以匹配依赖要求。

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