Jenkins使用Groovy获取构建详情作为参数返回null排查

• 运行权限差异：直接在Jenkins脚本控制台执行代码时，运行环境是无沙箱的管理员全权限模式，可以无限制调用Jenkins内部API；但Active Choices Parameter的Groovy脚本默认运行在Script Security沙箱内，没有权限调用Jenkins.instance、getItemByFullName这类内部方法，且沙箱拦截方法调用时不会抛出可被业务代码catch的常规异常，会直接中断脚本执行返回null。
• 返回值格式不符合要求：Active Choices Parameter（无论单选/多选类型）强制要求脚本返回List/数组类型的可选值集合，原脚本的正常分支返回单个字符串类型，不符合参数的解析规则，会被判定为无效值返回null。
• 空指针场景未做兜底：如果目标路径下的项目从未有过成功构建，getLastSuccessfulBuild()本身会返回null，直接调用.displayName会触发空指针异常。

1. 解决沙箱权限问题
   • 用管理员账号进入「系统管理 > Script Security（脚本安全）」页面，在待批准的方法签名列表中，找到这段脚本触发的method jenkins.model.Jenkins getItemByFullName java.lang.String、method hudson.model.Job getLastSuccessfulBuild、method hudson.model.Run getDisplayName相关签名，全部点击批准。
   • 确认当前任务的匿名访问账号/触发构建的账号，对Folder1、folder2两层文件夹以及目标jenkins-project任务拥有读取权限，否则跨路径取任务信息会被权限校验拦截。
2. 调整脚本逻辑，兼容参数格式要求+空值兜底，修改后可直接使用的脚本如下：

import hudson.model.*
import jenkins.model.Jenkins

try {
    def targetJob = Jenkins.instance.getItemByFullName("Folder1/folder2/jenkins-project")
    def lastSuccessBuild = targetJob?.getLastSuccessfulBuild()
    def displayName = lastSuccessBuild ? lastSuccessBuild.displayName : "暂无历史成功构建"
    // 严格返回列表类型，符合Active Choices参数的格式要求
    return [displayName]
} catch (Exception e) {
    return ["构建名获取失败: ${e.message}"]
}

3. 配置后验证
   • 保存任务配置后强制刷新构建触发页面（清理浏览器缓存），避免加载旧的参数渲染结果。
   • 可以先把脚本临时改成return ["测试连通性"]，确认参数能正常渲染出测试选项，再逐步加业务逻辑排查问题。

注：不要用脚本控制台的运行结果作为参数脚本的正确性判断依据，二者的运行上下文、权限边界、返回值要求完全不同，运行结果没有参考一致性。

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