Jenkinsfile脚本中如何获取构建触发原因？

我来帮你解决这个Jenkinsfile里判断触发原因的问题，你遇到的两个报错我都很熟悉，咱们一步步来搞定它：

为什么之前的方法会报错？ #

先解释下你碰到的两个问题：

1. currentBuild.getCauses()报错：RunWrapper（也就是currentBuild的类型）根本没有无参的getCauses()方法，你用错了API。
2. getRawBuild()被沙箱拒绝：Jenkins的脚本安全沙箱默认禁止直接访问底层的Run对象，因为这可能带来安全风险，所以这种方式肯定走不通。

安全可行的解决方案 #

下面两种方法都不需要绕过沙箱，完全符合Jenkins的安全规范：

方法一：精准匹配触发原因类 #

用currentBuild.getBuildCauses(causeClassName)方法可以直接检查特定类型的触发原因，返回匹配的原因列表。只要列表不为空，就说明是该类型触发的。

示例代码：

// 判断是否为定时任务触发（对应TimerTrigger的Cause类）
def isCronTrigger = !currentBuild.getBuildCauses('hudson.triggers.TimerTrigger$TimerTriggerCause').isEmpty()

// 判断是否为Git代码推送触发（根据你用的SCM插件调整类名）
def isGitPushTrigger = !currentBuild.getBuildCauses('hudson.plugins.git.GitCause$SCMTriggerCause').isEmpty()

if (isCronTrigger) {
    echo "检测到定时任务触发，仅执行容器内脚本"
    // 这里写你的Docker容器内脚本执行逻辑
    sh "docker exec my-app-container /app/run-daily-job.sh"
} else if (isGitPushTrigger) {
    echo "检测到代码推送触发，执行完整构建流程"
    // 拉取代码、重建容器、静态分析、测试等步骤
    checkout scm
    sh "docker-compose down && docker-compose up --build -d"
    sh "./gradlew check" // 静态代码分析示例
    sh "./gradlew test" // 测试示例
} else {
    echo "触发类型未知（比如手动触发），执行默认流程"
    // 可选：处理其他触发场景
}

方法二：遍历所有触发原因（更灵活） #

如果你需要更灵活的判断，可以遍历currentBuild.causes里的所有原因对象，通过className或shortDescription来识别触发源：

// 查找定时任务触发原因
def cronCause = currentBuild.causes.find { cause ->
    cause.className == 'hudson.triggers.TimerTrigger$TimerTriggerCause'
}

if (cronCause) {
    echo "定时任务触发，执行容器内脚本"
    sh "docker exec my-container /path/to/script.sh"
} else {
    // 查找Git推送触发原因
    def gitPushCause = currentBuild.causes.find { cause ->
        cause.shortDescription.startsWith("Started by Git push")
    }
    if (gitPushCause) {
        echo "代码推送触发，执行完整构建"
        // 完整构建逻辑...
    }
}

常见触发源的Cause类参考 #

不同插件对应的触发原因类名不一样，给你列几个常用的：

• 手动触发：hudson.model.Cause$UserIdCause
• GitHub推送：org.jenkinsci.plugins.github.webhook.GithubPushCause
• GitLab推送：com.dabsquared.gitlabjenkins.cause.GitLabWebHookCause
• 定时任务：hudson.triggers.TimerTrigger$TimerTriggerCause
• SCM轮询触发：hudson.triggers.SCMTrigger$SCMTriggerCause

注意事项 #

• 确保你的Jenkins Pipeline插件是较新版本，有些方法是在后续版本中添加的。
• 如果找不到对应的Cause类，可以先在Jenkins构建页面的“触发原因”里看描述，或者临时加一句echo currentBuild.causes来打印所有原因的详细信息，从中提取类名。

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