Jenkins pipeline credentials单双引号插值使用问题咨询

架构老林

2026-10-7

问题核心原因

你出现401错误是两个点叠加导致的：

Groovy 语法中单引号包裹的字符串本身不支持本地变量插值，你用def keyvar = credentials('key_id')定义的是Groovy本地变量，单引号里的$keyvar不会被替换为实际值，只会把$keyvar作为明文字符串传给Authorization头，自然认证失败。
Jenkins官方提到的「避免Groovy字符串插值」的规则，前提是你把凭证存入了Jenkins环境变量，不是普通的Groovy本地变量，httpRequest插件只会主动解析环境变量中的值替换单引号内的变量标记。

正确实现方式

方案1：声明式Pipeline用environment块定义环境变量

把凭证放在environment块中定义为Jenkins全局环境变量，httpRequest插件会自动识别替换单引号内的变量：

pipeline {
    agent any
    environment {
        // 此处定义的是Jenkins环境变量，而非Groovy本地变量
        keyvar = credentials('key_id')
    }
    stages {
        stage('发起请求') {
            steps {
                script {
                    def response = httpRequest url: "https://url...", 
                        customHeaders: [[name: 'Authorization', value: '$keyvar']]
                }
            }
        }
    }
}

方案2：脚本式Pipeline用withEnv临时注入环境变量

如果是脚本式Pipeline不想定义全局环境变量，可以用withEnv临时注入，作用域只在代码块内：

node {
    withEnv(["keyvar=${credentials('key_id')}"]) {
        def response = httpRequest url: "https://url...", 
            customHeaders: [[name: 'Authorization', value: '$keyvar']]
    }
}