Jenkins首次加载时二级级联参数无法刷新问题求助

问题背景 #

Jenkinsfile定义了三级联动参数：

• ENVIRONNEMENT：固定下拉选项，默认选中第一个值dev
• MAVEN_TYPE：依赖ENVIRONNEMENT，当环境为prod/pprod时仅显示releases，其他环境显示releases+snapshots
• VERSION：依赖MAVEN_TYPE，从Nexus仓库拉取对应类型的最新5个版本

参数切换时联动逻辑正常，但首次加载参数表单时，MAVEN_TYPE持续显示加载动画无法选择，必须切换ENVIRONNEMENT到其他选项再切回才能正常使用。

环境信息：

• 异常环境：Jenkins v2.479.2 + Active Choices v2.8.6
• 正常环境：Jenkins v2.303.2 + Active Choices v2.5.6
• 特殊现象：移除VERSION参数后，MAVEN_TYPE首次加载正常

已尝试：给MAVEN_TYPE的脚本添加默认值def env = ENVIRONNEMENT ?: 'dev'，问题未解决。

可能原因 #

新版本Active Choices插件在多级联动参数的初始化顺序上存在竞态问题：VERSION的加载请求先于MAVEN_TYPE的初始化完成，导致MAVEN_TYPE的渲染被阻塞。

解决方案 #

方案1：给VERSION添加多参数依赖 #

修改VERSION的referencedParameters，同时关联ENVIRONNEMENT和MAVEN_TYPE，确保参数初始化顺序正确：

[
  $class: 'CascadeChoiceParameter',
  name: 'VERSION',
  choiceType: 'PT_SINGLE_SELECT',
  description: 'Version to deploy',
  filterLength: 1,
  filterable: false,
  referencedParameters: 'ENVIRONNEMENT,MAVEN_TYPE', // 同时依赖两个参数
  script: [
    $class: 'GroovyScript',
    script: [classpath: [], sandbox: false, script: ('''import javax.xml.parsers.*
      import groovy.util.XmlSlurper
      import hudson.util.Secret
      def creds = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(com.cloudbees.plugins.credentials.Credentials.class, hudson.security.ACL.SYSTEM);
      def cred = creds.find { it.id == 'jenkins-nexus-user' }
      def authString = "${cred.username}:${Secret.toString(cred.password)}".getBytes().encodeBase64().toString()
      def connection = (HttpURLConnection) new URL("https://nexus.url/repository/maven-${MAVEN_TYPE}/com/company/project/maven-metadata.xml").openConnection()
      connection.setRequestProperty("Authorization", "Basic ${authString}")
      if (connection.responseCode == HttpURLConnection.HTTP_OK) {
        def response = new XmlSlurper().parse(connection.inputStream)
        def versions = response.versioning.versions.version.collect { it.toString() }
        return versions.reverse().take(5)
      }''')],
      fallbackScript: [classpath: [], sandbox: false, script: ('''return ["Error retreiving versions"]''')]
    ]
  ]
]

方案2：明确MAVEN_TYPE的返回逻辑 #

优化MAVEN_TYPE的脚本，确保返回明确的非空选项列表，避免逻辑歧义：

[
  $class: 'CascadeChoiceParameter',
  name: 'MAVEN_TYPE',
  choiceType: 'PT_SINGLE_SELECT',
  filterLength: 1,
  filterable: false,
  referencedParameters: 'ENVIRONNEMENT',
  script: [
    $class: 'GroovyScript',
    script: [classpath: [], sandbox: false, script: ('''
      def selectedEnv = ENVIRONNEMENT ?: 'dev'
      return (selectedEnv in ['prod', 'pprod']) ? ['releases'] : ['releases', 'snapshots']
    ''')]
  ]
]

方案3：切换参数类型为ActiveChoicesReactiveReferenceParameter #

使用新版本插件中对联动支持更稳定的ActiveChoicesReactiveReferenceParameter替换CascadeChoiceParameter：

[
  $class: 'ActiveChoicesReactiveReferenceParameter',
  name: 'MAVEN_TYPE',
  choiceType: 'PT_SINGLE_SELECT',
  filterLength: 1,
  filterable: false,
  referencedParameters: 'ENVIRONNEMENT',
  script: [
    $class: 'GroovyScript',
    script: [classpath: [], sandbox: false, script: ('''
      def selectedEnv = ENVIRONNEMENT ?: 'dev'
      return (selectedEnv in ['prod', 'pprod']) ? ['releases'] : ['releases', 'snapshots']
    ''')]
  ]
]

方案4：临时降级插件版本 #

若上述方案均无效，可暂时将Active Choices插件降级到v2.5.6（与旧环境一致），但该方案仅为临时过渡，建议优先适配新版本逻辑。

验证步骤 #

1. 修改Jenkinsfile中的参数配置并保存
2. 触发流水线进入参数表单页面
3. 观察MAVEN_TYPE是否在首次加载时正常显示选项，无需切换环境

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