Jenkins Active Choices插件读取JSON生成动态参数问题求助

核心问题分析 #

1. 静态参数阶段无法访问仓库文件：properties()中定义的Active Choices参数在Pipeline启动前、代码仓库克隆前执行，此时工作区还不存在仓库内的jenkins.appflow.json，因此无论是Pipeline的readJSON步骤还是文件读取操作都会失败。
2. Active Choices脚本限制：该插件的Groovy脚本运行在Jenkins Master的沙箱环境中，无法直接使用Pipeline DSL特有的readJSON等步骤，只能用Groovy原生API。
3. 参数格式错误：在stage内生成参数时若返回字符串形式的列表（如[Production, Test]），Jenkins无法识别，必须返回Groovy原生的List对象。

解决方案 #

方案1：配置文件存放在Jenkins服务器本地

若可将jenkins.appflow.json放到Jenkins Master的固定目录（如/var/lib/jenkins/configs/），可使用Groovy原生的JsonSlurper读取配置：

修改Environment参数的脚本：

script: '''
import groovy.json.JsonSlurper

// 配置文件在Jenkins服务器的绝对路径
def configFile = new File('/var/lib/jenkins/configs/jenkins.appflow.json')
def jenkinsAppflowConfig = new JsonSlurper().parse(configFile)
return jenkinsAppflowConfig.environments.keySet().toList()
'''

修改Saleschannels参数的脚本：

script: '''
import groovy.json.JsonSlurper

def configFile = new File('/var/lib/jenkins/configs/jenkins.appflow.json')
def jenkinsAppflowConfig = new JsonSlurper().parse(configFile)
return jenkinsAppflowConfig.environments[Environment] ?: []
'''

注意：需确保Jenkins系统用户（如jenkins）拥有该文件的读取权限，同时在Jenkins脚本审批中允许File类和JsonSlurper的使用。

方案2：配置文件在代码仓库内，使用动态input步骤

由于静态参数阶段无法访问仓库文件，可在Pipeline首个stage中先拉取代码，再通过input步骤生成动态参数：

pipeline {
  agent any

  stages {
    stage('加载配置并获取参数') {
      steps {
        script {
          // 显式拉取代码（多分支Pipeline可省略，但显式操作更稳妥）
          checkout scm

          // 读取配置文件
          def jenkinsAppflowConfig = readJSON file: 'jenkins.appflow.json'
          def envOptions = jenkinsAppflowConfig.environments.keySet().toList()

          // 选择部署环境
          selectedEnv = input(
            id: 'envInput',
            message: '选择部署环境',
            parameters: [
              choice(
                name: 'Environment',
                choices: envOptions.join('\n'),
                description: '选择目标环境'
              )
            ]
          )

          // 根据环境获取销售渠道选项
          def saleschannelOptions = jenkinsAppflowConfig.environments[selectedEnv]
          selectedSaleschannels = input(
            id: 'saleschannelInput',
            message: '选择销售渠道',
            parameters: [
              extendedChoice(
                name: 'Saleschannels',
                type: 'PT_MULTI_SELECT',
                value: saleschannelOptions.join('\n'),
                description: '选择要部署的销售渠道'
              )
            ]
          )
        }
      }
    }

    stage('iOS & Android Pipeline') {
      steps {
        script {
          echo "选择的环境: ${selectedEnv}"
          echo "选择的销售渠道: ${selectedSaleschannels}"
          // 后续部署步骤
        }
      }
    }
  }
}

注意：需安装Extended Choice Parameter插件支持多选功能；input步骤会暂停Pipeline等待用户输入，适合手动触发的场景。

修复stage内参数格式问题

若之前在stage内生成参数时出现格式错误，需确保返回的是Groovy原生List对象，而非字符串化的列表：

// 正确：返回List对象
def jenkinsAppflowConfig = readJSON file: 'jenkins.appflow.json'
return jenkinsAppflowConfig.environments.keySet().toList()

避免返回字符串形式的列表（如"[Production, Test]"），此类格式Jenkins无法识别。

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