Jenkins Job DSL使用withCredentials保护Bitbucket凭证报错如何解决

你遇到的错误是Job DSL运行上下文未正确加载Credentials Binding插件的usernamePassword快捷方法，属于作用域缺失/插件版本兼容问题，不是语法错误。

按优先级依次尝试：

1. 替换为兼容度更高的绑定写法 #

usernamePassword是Credentials Binding插件较高版本新增的快捷方法，部分旧版本或者Job DSL上下文不支持，直接替换为指定类的全量写法即可：

withCredentials([[
    $class: 'UsernamePasswordMultiBinding',
    credentialsId: 'bitbucket-app-pass',
    usernameVariable: 'USERNAME',
    passwordVariable: 'PASSWORD'
]]) {
    if (enableAuthentication) {
        String username = USERNAME
        String password = PASSWORD

        // Create authorization header using Base64 encoding
        String userpass = username + ":" + password;
        // 注意：Java 11+ 已移除javax.xml.bind.DatatypeConverter，建议用以下写法兼容
        String basicAuth = "Basic " + java.util.Base64.getEncoder().encodeToString(userpass.getBytes());
 
        // Set authorization header
        connection.setRequestProperty ("Authorization", basicAuth)
    }
}

2. 确认必备插件已安装 #

检查Jenkins插件管理中已安装以下插件且版本兼容：

• Credentials 插件（≥2.6.0）
• Credentials Binding 插件（≥1.27）
• Job DSL 插件（≥1.77）

3. 自定义工具类上下文适配 #

如果你是在自定义的utilities工具类中编写的这段逻辑，需要将当前脚本实例传入工具类，调用时指定上下文：
工具类方法示例：

def getBitbucketAuth(Script script, String credentialsId, boolean enableAuthentication) {
    script.withCredentials([[
        $class: 'UsernamePasswordMultiBinding',
        credentialsId: credentialsId,
        usernameVariable: 'USERNAME',
        passwordVariable: 'PASSWORD'
    ]]) {
        if (enableAuthentication) {
            String userpass = "${script.USERNAME}:${script.PASSWORD}"
            return "Basic " + java.util.Base64.getEncoder().encodeToString(userpass.getBytes())
        }
        return null
    }
}

主脚本调用时传入当前实例this即可：

def basicAuth = utils.getBitbucketAuth(this, 'bitbucket-app-pass', enableAuthentication)
if (basicAuth) {
    connection.setRequestProperty ("Authorization", basicAuth)
}

如果你的Jenkins运行在Java 11及以上版本，原代码中用到的javax.xml.bind.DatatypeConverter已经从JDK默认移除，务必替换为示例中java.util.Base64的写法，避免后续抛出类不存在错误。

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