You need to enable JavaScript to run this app. Jenkins升级2.249.3后下游任务传参缺失、手动配置的参数自动丢失
优惠活动
大模型
产品
解决方案
定价
更多

Jenkins升级2.249.3后下游任务传参缺失、手动配置的参数自动丢失

异常根因定位

升级后出现的参数不识别、手动添加的配置自动消失,本质是三类因素叠加导致的:

1. 版本迭代移除了旧版宽松兼容逻辑

  • Jenkins 2.249.3内置的Pipeline Groovy插件,正式上线了JENKINS-34871对应的修复逻辑:取消了build步骤传参时的无校验透传机制。在旧版2.164.3环境中,上游通过build步骤传递的参数,哪怕下游任务没有预先定义,也能直接被下游脚本读取。
  • 新版环境下,build步骤会在传参时强制校验引用的Groovy变量是否存在,一旦引用了未定义的属性,会直接抛出MissingPropertyException阻断流水线运行。

2. 参数自动消失的触发机制

当下游Job_2为流水线类型任务,且自身Jenkinsfile中没有通过原生parameters{}块显式声明参数定义时,Pipeline插件会在每次被上游触发时,执行参数自动同步流程:用本次上游触发携带的参数列表,覆盖任务在UI上手动配置的参数定义。

  • 如果本次触发过程中因为参数校验失败、脚本执行中断,自动同步流程会被中断,插件会回滚到任务最近一次持久化的配置快照。这个快照通常是任务最初未配置任何参数的初始状态,会直接覆盖手动在UI上新增的参数配置,哪怕之前已经点击保存。

3. 脚本本身存在硬编码错误

从提供的流水线逻辑可以直接看到变量名不匹配的问题:

  • try块中赋值的变量为create_cluster_build_id
  • 传参时引用的变量为Job_1_id
    这个变量从未在脚本中赋值,本身就是触发MissingPropertyException的直接原因,只是旧版的宽松校验掩盖了这个问题。
修复方案
  • 先修正脚本中的变量名不匹配问题,确保上游在执行build步骤前,所有要传递的参数都有明确赋值,不存在未定义的Groovy变量。
  • 放弃通过UI手动添加参数的临时方案,在下游Job_2的Jenkinsfile中通过parameters块显式声明所有需要接收的参数,参考实现:
pipeline {
  parameters {
    string(name: 'Branch', defaultValue: '', description: '上游传入的代码分支')
    string(name: 'Docker_Tag', defaultValue: '', description: '上游传入的镜像标签')
    string(name: 'upstream_name', defaultValue: '', description: '上游任务名称')
    string(name: 'upstream_build_id', defaultValue: '', description: '上游构建编号')
    string(name: 'upstream_build_url', defaultValue: '', description: '上游构建地址')
    string(name: 'Job_1_id', defaultValue: '', description: 'Job_1生成的资源ID')
  }
  // 原有流水线逻辑
}
  • 只要Jenkinsfile中存在静态的parameters块定义,Pipeline插件会自动跳过参数自动同步/覆盖流程,不会再修改任务已保存的参数配置,从根源上解决参数被自动清空的问题。
  • 若下游为自由风格任务,直接在任务配置的参数化构建区块完整配置所有上游需要传递的参数,删除上游传参列表中的冗余值,确保上下游参数定义完全匹配即可。

注意:只要下游流水线任务没有静态parameters块定义,每次上游触发都存在配置被回滚清空的风险,不要依赖UI手动配置的方案长期运行。


内容的提问来源于stack exchange,提问作者NZL

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 09:24:07