一、为什么会有混用冲突？

在 Jenkins Pipeline 中，主干逻辑（逻辑分支判断、参数读取、并行调度）运行在 Master 节点的 Groovy 运行环境中，而实际干活的构建指令（Docker 启停、编译打包、系统排障）则通过 sh 步骤交给 Worker Agent 的 Bash 进程执行。

这两种脚本语言共存时，最容易产生严重混淆的就是变量插值语法：

• Groovy 使用 ${variable} 引用其环境上下文中的变量；
• Bash 同样使用 ${variable} 引用环境变量或局部变量。

如果对两种语言的解释顺序和转义机制理解不清，经常会遇到“变量被意外提前置空”、“特殊字符引发语法崩溃”或“退出码被吞掉导致流水线假成功”的问题。

---

二、三双引号与三单引号的本质区别

在 Jenkins 中编写 sh 步骤时，引号的选用决定了变量解析的发生的地点：

1. 三单引号 '''...'''（纯 Bash 模式，推荐）

三单引号是纯粹的原始字面量字符串，Groovy 编译器不会做任何插值运算，内部的所有语法完全保留给原生 Bash 解释：

// ✅ 此时所有的 ${PATH}、$(date) 都由 Bash 原生解释执行
sh '''
    current_time=$(date "+%Y-%m-%d %H:%M:%S")
    echo "当前系统时间是: ${current_time}"
'''

2. 三双引号 """..."""（插值混合模式）

如果需要在 Bash 脚本中注入 Groovy 运行时变量，必须使用三双引号。此时必须严格区分哪些变量归 Groovy，哪些归 Bash：

def appName = "order-service"      // Groovy 变量
def buildVersion = "v1.2.0"       // Groovy 变量

sh """
    echo "正在部署应用: ${appName}, 版本: ${buildVersion}"  # 由 Groovy 插值替换

    # 关键：凡是需要在远程 Bash 中运行时解析的变量或管道命令，必须加反斜杠转义！
    container_id=\$(docker ps -q --filter "name=${appName}")
    if [ -n "\${container_id}" ]; then
        echo "发现正在运行的容器: \${container_id}，准备优雅停止..."
        docker stop "\${container_id}"
    fi
"""

铁律总结：

• 希望在 Master 上立即解析的 Groovy 变量：写作 ${var}；
• 希望在 Agent 端运行时由 Bash 动态解析的变量：写作 \${var} 或 \$var；
• 命令行命令替换语法：写作 \$(command)。

---

三、精准获取与判断 Shell 执行结果

默认情况下，sh 执行如果返回非 0 状态码，流水线会直接报错中断。但在需要做条件分支补偿的场景中，我们需要截获退出码或捕获标准输出：

1. 捕获命令标准输出：returnStdout: true

// 动态查询 Docker Compose 正在运行的项目路径
def composePath = sh(
    script: 'docker compose ls | awk \'/web-service/ {print $3}\' | head -1',
    returnStdout: true
).trim()

echo "解析得到的项目部署路径为: ${composePath}"

2. 自定义捕获退出状态码：returnStatus: true

// 检查某个微服务端口是否处于监听状态
def portStatus = sh(
    script: 'ss -tulpn | grep -q ":8080"',
    returnStatus: true
)

if (portStatus == 0) {
    echo "端口 8080 处于监听状态，服务已就绪"
} else {
    echo "端口未就绪，开始执行服务拉起..."
}

---

四、生产环境复杂业务准入判断示例

结合动态正则提取与条件链，实现精准的环境准入控制：

def validateDeploymentGate(String servicePath, boolean isMasterNode) {
    // 提取部署路径中的 8 位日期戳
    def deployDate = sh(
        script: "echo '${servicePath}' | grep -oE '[0-9]{8}'",
        returnStdout: true
    ).trim()

    def requiredBaselineDate = "20260901"

    if (deployDate >= requiredBaselineDate && isMasterNode) {
        echo "符合自动化升级准入条件（版本日期: ${deployDate}，且为主控节点）"
        return true
    } else {
        echo "不满足准入门禁：版本未达基线或非主节点，跳过本次升级"
        return false
    }
}