Jenkins Pipeline中Groovy与Bash变量混用的语法问题

AI 小北

2026-8-16

Jenkins Pipeline Shell步骤中Groovy与Shell变量混用问题排查与修复

问题根源

Groovy与Shell变量插值冲突：原代码使用Groovy双引号多行字符串，Groovy会自动解析其中的${GITLAB_GROUP}、$GITLAB_TOKEN，但连Shell变量$groupName也会被Groovy尝试插值——Groovy无法识别该变量，要么替换为空值，要么直接抛出异常，导致Shell执行逻辑混乱。
curl命令语法错误：URL末尾的"是HTML转义的引号，属于无效语法；private_token=$GITLAB_TOKEN后面多余的&会破坏URL结构，导致GitLab API请求失败。
Shell变量未加引号：cat $groupName.lang如果groupName值包含空格，会被Shell拆分成多个参数，触发执行错误。

修复方案

针对变量冲突，有两种常用修复方式，同时修正curl的语法问题：

方式一：用单引号多行字符串（完全交给Shell处理）

Groovy单引号字符串不会做任何插值，所有变量解析都交给Shell，Jenkins环境变量直接用$变量名引用即可：

stage('Counting Codes') {
    steps {
        sh '''
           groupName=$(curl -X GET "https://gitlab.com/api/v4/groups/${GITLAB_GROUP}?private_token=${GITLAB_TOKEN}" | jq '.path' --raw-output)
           cat "${groupName}.lang"
        '''
    }
}

方式二：用双引号多行字符串，转义Shell变量

如果需要Groovy层面处理变量（比如拼接Jenkins环境变量），可以对Shell变量加反斜杠转义\$，阻止Groovy插值，同时用${env.变量名}明确引用Jenkins环境变量：

stage('Counting Codes') {
    steps {
        sh """
           groupName=\$(curl -X GET "https://gitlab.com/api/v4/groups/${env.GITLAB_GROUP}?private_token=${env.GITLAB_TOKEN}" | jq '.path' --raw-output)
           cat "\${groupName}.lang"
        """
    }
}