迁移升级Jenkins至2.401.3后构建历史缺失但Stage View正常，求排查指导

问题根源&修复方案 #

构建历史不显示但Stage View能访问旧构建，说明构建数据本身完整，只是主界面读取历史的逻辑异常，常见原因及解决方法如下：

1. 目录权限错误 #

复制JENKINS_HOME时，新服务器的Jenkins运行用户（一般是jenkins）没有读取构建目录的权限：

• 检查目标job的构建目录权限：ls -l /var/lib/jenkins/jobs/<你的任务名>/builds/，确保所有者和组为jenkins:jenkins。
• 批量修复权限：chown -R jenkins:jenkins /var/lib/jenkins/，然后重启Jenkins服务。

2. 构建索引文件损坏 #

每个job的builds/builds.xml是Jenkins用来索引构建历史的核心文件，复制过程中可能损坏：

• 进入对应job的builds目录，查看builds.xml是否存在、内容是否为合法XML（应包含所有构建ID的列表）。
• 若文件损坏，从旧服务器重新复制该文件；或者直接删除builds.xml后重启Jenkins，系统会自动重新生成索引（重启后需等待几分钟完成重建）。

3. 插件兼容性问题 #

升级到2.401.3后，Pipeline或构建相关插件可能存在版本兼容问题：

• 进入Jenkins插件管理页面，检查并更新所有与Pipeline、构建历史相关的插件（比如Pipeline Stage View Plugin、Job Plugin）。
• 若更新后仍有问题，尝试禁用再重新启用Pipeline Stage View Plugin，或临时回滚到旧版本插件测试。

4. 缓存文件干扰 #

Jenkins的缓存或临时文件可能导致界面读取异常：

• 停止Jenkins服务，删除JENKINS_HOME/caches/和JENKINS_HOME/war/目录（war目录会在重启后自动重建）。
• 重启Jenkins，等待服务完全加载后再检查构建历史。

5. 符号链接失效 #

如果旧服务器的构建目录使用了符号链接，复制到新服务器后链接可能失效：

• 检查job的builds目录下是否有符号链接，确保链接指向新服务器上的有效路径；若无效，替换为实际的构建目录。

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