如何在Jenkins流水线中正确访问GITHUB_TOKEN凭证以避免groovy.lang.MissingPropertyException异常

这个报错的核心原因很明确：你在调用自定义的withGithubCredentials方法时，传递的是一个未定义的变量GITHUB_TOKEN，而不是凭证ID的字符串字面量。Groovy会把裸写的GITHUB_TOKEN当成变量去查找，但当前脚本上下文里根本没有这个变量，所以抛出了MissingPropertyException。

下面是修复后的完整流水线代码：

def downloadGitAssets(String owner, String repo_name, String tag, String assert_name) {
    dir("scripts") {
        // 这里要传字符串形式的凭证ID "GITHUB_TOKEN"，而不是裸写的变量
        withGithubCredentials("GITHUB_TOKEN") {
            return sh(
                script: "./git_assets_download.sh ${GITHUB_TOKEN} ${owner} ${repo_name} ${tag} ${assert_name}",
                returnStdout: true,
            ).trim()
        }
    }
}

def withGithubCredentials(credentialsId, body) {
    withCredentials([
        string(
            credentialsId: credentialsId,
            variable: "GITHUB_TOKEN"
        ),
    ]) {
        body()
    }
}

关键修复点说明： #

• 调用withGithubCredentials时，传入带引号的字符串"GITHUB_TOKEN"，这才是你在Jenkins中创建的凭证的ID，Groovy会把它当作普通字符串参数传递，而不是去解析成变量。
• 在withCredentials块内部，Jenkins会把凭证的实际值注入到名为GITHUB_TOKEN的变量中，这个变量在闭包body()的范围内是完全可用的，所以你可以在sh脚本里直接引用它，不用额外处理。

额外注意事项： #

• 确认Jenkins系统中确实存在ID为GITHUB_TOKEN的字符串类型凭证，并且执行流水线的用户/角色有访问该凭证的权限。
• 如果你需要更安全的传递方式（比如避免在脚本中直接拼接变量），可以考虑让git_assets_download.sh通过环境变量读取凭证值，比如在withCredentials里把变量设为环境变量，然后脚本里用$GITHUB_TOKEN读取，但当前的写法已经是Jenkins推荐的安全方式，因为withCredentials会自动对敏感变量进行掩码处理，不会在日志中泄露。

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