Jenkins脚本化流水线Curl请求语法错误排查及基于HTTP状态码的流水线中止方案咨询

首先来看你遇到的两个核心问题：语法错误和更高效的状态码校验方式，咱们一步步来解决：

一、修复当前的Curl语法错误 #

你的代码有两个关键问题：

1. Groovy字符串的反斜杠转义问题：在双引号包裹的字符串中，反斜杠\是转义字符，如果你想表示普通反斜杠需要写成\\；但其实你这里的反斜杠是用来换行的，完全可以去掉，或者用Groovy的多行字符串（三个单引号）来避免转义麻烦。
2. 重复调用curl的逻辑错误：你把完整的curl命令存在了url变量里，但在sh步骤中又写了一次curl -s -w ... $url，这相当于执行了curl [参数] curl [你的原始命令]，明显会导致命令解析失败。

修正后的代码示例：

stage('Getting external API') { 
    steps { 
        script{ 
            // 单独抽离API地址，避免命令字符串混乱
            final String apiUrl = "https://my-endpoint-test/operations/promote/Approved"
            // 构造正确的curl命令，仅提取响应状态码
            def responseCode = sh(
                script: "curl -s -w '%{response_code}' -o /dev/null '${apiUrl}' -H 'accept: */*'", 
                returnStdout: true
            ).trim()
            
            echo "HTTP response status code: $responseCode"
            
            if (responseCode != "200") { 
                error('URL status is not 200. Exiting pipeline.') 
            } 
        } 
    } 
}

这里的优化点：

• 用-o /dev/null丢弃响应体，只保留状态码输出，更简洁
• 用trim()去除状态码前后空白，避免判断时的意外问题

二、更简便的中止流水线方式 #

其实不用手动提取状态码再判断，可以让curl直接根据响应状态码返回非零值，Jenkins的sh步骤默认会在命令返回非零值时中止流水线，代码会更简洁：

stage('Getting external API') { 
    steps { 
        sh '''
            curl -f -s -o /dev/null -H 'accept: */*' \
            'https://my-endpoint-test/operations/promote/Approved'
        '''
        echo "API returned 200 OK, continuing pipeline..."
    } 
}

这里的-f参数是核心：当curl收到非200的响应码时，会返回非零退出状态，Jenkins会自动中止流水线，不需要额外的判断逻辑。

如果需要保留状态码输出用于排查，可以结合-w和set -e：

stage('Getting external API') { 
    steps { 
        script {
            sh '''
                set -e
                STATUS_CODE=$(curl -s -w '%{response_code}' -o /dev/null -H 'accept: */*' \
                'https://my-endpoint-test/operations/promote/Approved')
                echo "HTTP response status code: $STATUS_CODE"
                if [ "$STATUS_CODE" != "200" ]; then
                    exit 1
                fi
            '''
        }
    } 
}

额外提示：使用Jenkins HTTP Request插件 #

如果你的Jenkins安装了HTTP Request插件，可以用更贴合流水线风格的语法实现，避开shell语法的坑：

stage('Getting external API') { 
    steps { 
        def response = httpRequest(
            url: 'https://my-endpoint-test/operations/promote/Approved',
            httpMode: 'GET',
            headers: [[name: 'accept', value: '*/*']]
        )
        echo "HTTP response status code: ${response.status}"
        
        if (response.status != 200) {
            error('URL status is not 200. Exiting pipeline.')
        }
    } 
}

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