修改正则并执行多分支扫描后Jenkins多分支构建历史丢失如何恢复

构建历史消失的核心原因 #

修改分支匹配正则后重新触发多分支扫描时，Jenkins会将不符合当前正则规则的分支判定为「已失效/已删除」，仅隐藏对应分支的构建记录，不会物理删除本地存储的构建文件，绝大多数场景都可以恢复。

优先尝试的快速恢复方案 #

• 先将多分支项目的分支匹配正则规则还原为修改前的配置，确保规则完全匹配旧版本的写法，不要遗漏任何分支匹配逻辑
• 重新触发一次多分支全量扫描，等待扫描结束后刷新项目页面，所有符合旧正则的分支对应的构建历史会自动恢复显示

正则无法还原时的手动恢复方案 #

如果已经找不到旧的正则规则，或者对应分支已经在远端代码库被删除，可以通过本地存储文件恢复：

• 登录Jenkins所在服务器，进入多分支项目的存储目录，默认路径为$JENKINS_HOME/jobs/你的多分支项目名称/branches/，该目录下保存了所有历史被识别过的分支的全部构建数据
• 找到你需要恢复的分支对应的目录，进入后打开builds文件夹即可直接查看所有历史构建的日志、参数、制品等内容
• 如果需要长期保留该分支的构建历史，可以将对应分支的整个目录迁移到任意普通Jenkins项目的jobs目录下，重启Jenkins后即可在对应项目中完整查看所有历史构建记录

避坑提示 #

• 修改多分支项目的正则规则前，建议先备份$JENKINS_HOME/jobs/你的多分支项目名称/目录，避免极端场景下的数据丢失
• 扫描过程中不要手动删除branches目录下的任何文件，否则会导致构建记录永久丢失

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