求助：Jenkins共享库脚本无法为Active Choices参数加载JSON选项

问题1解答 #

可以使用Jenkins共享库中的脚本为Active Choices参数加载选项，但要注意参数页面的Groovy脚本运行环境和构建流程环境存在差异：构建阶段会自动加载Jenkins配置好的共享库，但参数页面的脚本默认不会自动导入共享库vars目录下的脚本，需要手动处理加载逻辑。

问题2解决方案 #

你的核心问题是参数页面的Groovy脚本无法正确调用共享库中的loadMachineList()函数，因为参数页面上下文未自动加载共享库。按以下步骤修复：

1. 手动加载共享库
   在Active Choices的脚本块中，先显式加载共享库再调用函数，示例如下：

   script: [
       classpath: [],
       sandbox: false,
       script: '''
           // 替换为你在Jenkins中配置的共享库名称
           @Library('your-shared-lib-name') _
           return loadMachineList()
       '''
   ]
   

2. 检查返回值格式
   Active Choices参数要求选项为List类型，如果你的loadMachineList()返回的是逗号分隔的字符串，需要转换为List：

   • 要么在共享库脚本中直接返回List：

     // vars/loadMachineList.groovy
     def call() {
         def jsonData = readJSON file: 'path/to/your.json'
         // 假设JSON中machines字段是数组，直接返回；如果是字符串则拆分
         return jsonData.machines ?: "machine1,machine2".split(',')
     }
     

   • 要么在参数页面脚本中处理：

     return loadMachineList().split(',')
     

3. 排查权限与错误

   • 确认Jenkins安全配置允许参数页面脚本加载共享库、读取JSON文件；
   • 可临时修改脚本添加错误捕获与日志，方便定位问题：

     script: [
         classpath: [],
         sandbox: false,
         script: '''
             @Library('your-shared-lib-name') _
             try {
                 def list = loadMachineList()
                 println "Loaded machines: ${list}"
                 return list
             } catch (Exception e) {
                 println "Load failed: ${e.getMessage()}"
                 return ["Load error: ${e.getMessage()}"]
             }
         '''
     ]
     

     日志可在Jenkins系统日志中查看。

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