Jenkins LTS 版本升级后出现插件不兼容报错，通常是因为插件版本过低无法适配新核心或 Java 运行环境不满足要求。最稳妥的处理方向是在升级 Jenkins 核心前先更新所有插件，并在操作前完整备份 Jenkins 主目录以防回滚。

快速处理思路

如果不方便执行命令行操作，可通过 Jenkins Web 界面进行紧急处理。进入安全模式后，系统会跳过插件加载，允许管理员登录并管理插件。

访问路径通常为 http://<Jenkins 地址>/safeMode 或在启动参数中添加 -Djenkins.safeMode=true。在安全模式界面中，进入插件管理页面，卸载或降级报错的插件，然后重启服务。

为什么会这样

插件不兼容的核心原因是 Jenkins 核心 API 变更或 Java 版本要求提升。LTS 版本升级往往伴随内部依赖库的更新，旧版插件调用已废弃的接口会导致加载失败。

此外，新版本的 Jenkins 可能要求更高版本的 Java 运行环境，如果底层 Java 未同步升级，也会引发插件初始化错误。公开资料中没有看到可靠的量化数据说明具体多少比例的插件会受影响，但依赖核心内部实现的插件风险较高。

分步处理

第一步：备份数据

在执行任何升级或修复操作前，必须备份 JENKINS_HOME 目录。包含配置文件、构建历史和插件数据的完整备份是回滚的唯一保障。

第二步：检查兼容性警告

登录 Jenkins 管理界面，进入「系统管理」>「插件管理」。查看是否有插件标记为需要更新或存在兼容性警告。如果有，先在当前版本下更新所有插件。

第三步：升级核心版本

确认插件更新完毕后，再执行 LTS 核心版本升级。如果是通过包管理器安装，使用对应的升级命令；如果是 WAR 包部署，替换 WAR 文件。

第四步：处理报错插件

升级后若出现报错，记录日志中提到的插件名称。进入安全模式，找到该插件并禁用或卸载。如果该插件是关键依赖，寻找替代插件或联系插件维护者。

怎么验证是否生效

重启 Jenkins 服务后，访问「系统管理」>「系统信息」页面。确认「版本」字段显示为预期的 LTS 版本号，且页面顶部无红色报错横幅。

检查关键构建任务是否能正常触发和执行。查看后台日志文件（通常位于 JENKINS_HOME/jenkins.out 或系统日志目录），确认没有持续的插件加载异常堆栈信息。

常见坑

忽略 Java 版本要求：新 LTS 版本可能不再支持旧版 Java，升级核心前需确认官方文档对 Java 版本的最低要求。

一次性升级跨度太大：如果当前版本过低，建议分阶段升级 LTS 版本，避免跨越多个大版本导致配置不兼容。

未备份直接操作：直接替换 WAR 包或更新核心而不备份，一旦失败可能导致无法启动且数据丢失。

常见问题

升级后无法登录怎么办

尝试通过安全模式启动 Jenkins，或在配置文件中临时禁用安全域进行排查。如果是因为插件导致启动阻塞，安全模式通常能绕过插件加载。

可以回滚到旧版本吗

可以，但必须依赖升级前的备份。将 JENKINS_HOME 恢复到备份状态，并替换回旧版本的 WAR 包或安装包即可回滚。

如何查看具体的插件报错日志

在「系统管理」>「系统日志」中创建新的日志记录器，添加报错插件的包名，或查看服务器后台的标准输出日志文件。

参考来源

Jenkins 官方文档，页面标题：Upgrading Jenkins，URL：https://www.jenkins.io/doc/book/upgrading/