Jenkins 2.332.3更新后出现build queue loop重启无效如何排查解决

Jenkins 2.332.3是迭代中调整了核心队列序列化逻辑、构建触发器权限校验规则的LTS版本，升级后出现无征兆构建队列循环、重启无效的问题，通常是三类原因导致：

• 插件版本不兼容：该版本对构建调度、Pipeline执行的核心API做了不兼容变更，若升级核心时未同步升级Pipeline套件、SCM轮询插件、第三方构建触发类插件，旧版插件会错误将历史已完成构建识别为“待调度”状态，持续把重复构建推入队列。
• 持久化队列文件损坏：Jenkins会将待执行队列持久化存储在$JENKINS_HOME/queue.xml中，升级过程中若旧版本队列的序列化数据和新版本解析逻辑不匹配，会出现队列项状态标记错乱，哪怕手动清空页面上的队列，只要底层缓存文件未修正，重启后异常队列项会再次加载生成。
• 任务配置逻辑冲突：2.332.3修复了旧版本构建触发器可被脚本无权限修改的漏洞，部分在Pipeline中通过properties步骤动态配置触发器、或者写了构建完成后自触发逻辑的任务，会因为权限校验规则变化，出现每次构建执行完成就自动触发新一轮构建的死循环。

按以下顺序排查可以快速定位根因，不需要盲目重装或者回滚：

• 先查系统日志：进入「Manage Jenkins - System Log」，搜索queue、BuildableItem、triggerCause关键字，定位反复入队的构建ID对应的触发源，日志会直接记录是哪个插件、哪段逻辑发起的构建请求。
• 验证队列缓存是否损坏：停止Jenkins服务，备份后将$JENKINS_HOME/queue.xml重命名为其他文件名，同时删除同目录下的queue.xml.bak等队列备份文件，再启动服务观察。如果启动后队列不再自动生成，即可确认是持久化缓存损坏导致的故障。
• 核对插件兼容性：进入「Manage Jenkins - Plugin Manager」，查看所有和构建调度、Pipeline执行、SCM拉取、构建触发相关的插件，确认是否存在版本低于2.332.3核心兼容基线的情况，插件管理页会直接标注每个插件对当前核心版本的兼容状态。
• 核对异常任务配置：找到反复入队的对应任务，查看构建历史里每条记录的“触发原因”字段，确认是SCM轮询触发、脚本触发还是触发器自动触发；如果是Pipeline任务，检查脚本中是否存在无判断条件就调用build步骤触发当前任务、或者每次执行都重写触发器配置的逻辑。

对应排查到的根因直接处理即可：

• 若为队列缓存损坏：直接删除损坏的queue.xml及对应备份文件后重启服务即可，该操作只会清空待执行队列，不会丢失任何已完成的构建历史，后续手动补录需要执行的待运行任务即可。
• 若为插件兼容性问题：将所有不兼容的插件升级到适配2.332.3的稳定版本后重启服务；如果是停止维护的第三方插件无适配版本，直接禁用该插件，改用核心自带的对应功能替代。
• 若为任务配置逻辑冲突：
  • 对动态配置触发器的Pipeline任务，进入任务配置页手动重新保存一次触发器配置，让新版本的权限规则重新写入任务配置文件，即可解决触发器反复重置触发的问题
  • 对存在自触发逻辑的任务，在触发判断逻辑中增加参数校验、并发构建限制，避免无限制循环触发
  • 排查期间可以临时禁用异常循环的任务快速止损，避免占用过多构建资源

所有配置文件修改操作前必须做好备份，不要直接删除整个JENKINS_HOME目录，避免历史构建、配置数据丢失。

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