Jenkins Build With Parameters同时显示新旧参数字段问题求助

核心原因 #

Jenkins 在显示「Build With Parameters」界面时，不仅会读取当前流水线的参数定义，还可能从分支的构建历史元数据或流水线配置缓存中加载旧参数。当从自定义流水线切换到共享库流水线后，旧参数并没有被完全清理，而是保留在这些持久化的缓存/历史记录中，导致新旧参数并存。而新建分支没有历史构建记录和缓存，所以只会显示共享库定义的新参数。

解决步骤 #

1. 删除分支的所有历史构建记录 #

Jenkins 可能从过往构建中读取参数模板。删除该分支的所有旧构建后，重新触发构建：

• 进入问题分支的 job 页面 → 点击「Build History」→ 选中所有旧构建 → 点击「Delete」。
• 若需要保留历史记录，可将旧构建标记为「Not to be kept」，再通过「Build Cleaner」插件清理，但直接删除是最快的测试方式。

2. 清理流水线配置缓存 #

通过 Jenkins 脚本控制台清除目标分支的流水线缓存：

1. 进入「Manage Jenkins」→「Script Console」。
2. 执行以下 Groovy 脚本（替换占位符为实际路径和分支名）：

   def job = Jenkins.instance.getItemByFullName("你的Job完整路径")
   def branch = job.getBranch("问题分支名")
   if (branch) {
       branch.getPipelineCache().clear()
       job.save()
       println "缓存已清除"
   } else {
       println "未找到指定分支"
   }
   

3. 清理 Jenkins 主目录中的残留文件 #

若删除分支文件夹后问题仍存在，可手动清理残留的缓存文件：

1. 先停止 Jenkins 服务。
2. 进入 Jenkins 主目录（通常是 $JENKINS_HOME）：
   • 删除 jobs/<你的Job名>/branches/<问题分支名>/builds/ 下的所有文件。
   • 检查 caches/ 目录下是否有该分支的相关缓存文件并删除。
3. 重启 Jenkins 后重新触发构建。

4. 强制流水线重新解析 #

触发构建时强制 Jenkins 重新读取共享库的最新定义：

• 使用「Replay」功能重新运行流水线，该操作会忽略缓存，从头解析 Jenkinsfile 和共享库。
• 若启用了「Lightweight checkout」，可在 job 配置中关闭该选项，确保每次构建都拉取最新的共享库代码。

5. 检查 Jenkinsfile 残留代码 #

确认 Jenkinsfile 中没有遗留旧的参数定义代码（比如未删除的 parameters 代码块），且共享库的导入语句（@Library('你的共享库名') _）正确无误。

补充说明 #

你提交的 JENKINS-69652 问题已确认这是 Jenkins 在流水线切换场景下的参数缓存行为问题，上述步骤可针对性解决该缓存残留导致的参数重复显示问题。

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