JenkinsFile管道脚本报错：未终止引号字符串，含单引号密码如何转义？

这个问题我之前也碰到过——当密码里包含单引号时，直接用单引号包裹会让shell误以为引号提前闭合，触发语法错误。咱们一步步来解决它：

问题根源 #

你的脚本里用'${PWD}'包裹密码，当密码是2'iblm98>#时，shell展开后会变成：

-Prdspass='2'iblm98># '

第一个'和密码里的'配对闭合了，剩下的iblm98># '就成了未闭合的字符串，自然报错。

解决方案：转义密码中的单引号 #

在Groovy里把密码里的单引号替换成shell能识别的转义序列'\''，这样就能让shell正确解析带单引号的密码了。修改后的脚本如下：

withCredentials([usernamePassword(credentialsId: 'test', usernameVariable: 'USER', passwordVariable: 'PWD')]) {
    // 转义密码中的单引号
    def escapedPwd = PWD.replace("'", "'\\''")
    sh "${gradle} -Prdsuser=${USER} -Prdspass='${escapedPwd}'"
}

原理说明 #

'\\''在Groovy中会被解析为'\''，这个序列在shell里的作用是：

1. '：闭合当前的单引号包裹
2. \'：输出一个单独的单引号（shell中转义单引号的标准方式）
3. '：重新打开单引号包裹继续后续内容

这样不管密码里有多少个单引号，都会被正确转义，不会破坏shell的引号结构。

额外提示 #

如果密码里还有其他shell特殊字符（比如#、>、$等），上面的方法依然有效——因为单引号在shell里会忽略绝大多数特殊字符，只有单引号本身需要转义。

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