Jenkins Pipeline执行失败求助：无明确报错信息

1. 明确Exit Code 7的具体含义 #

Exit Code 7是curl的标准错误码，对应无法建立到目标主机的连接，说明你的健康检查请求根本没触及到服务，而非服务返回错误响应。

2. 增强curl命令的日志输出 #

在test阶段的curl命令中添加详细参数，强制输出请求全流程信息，避免直接触发清理导致日志丢失：

# 替换原curl命令为以下内容
curl -v -w "\n=== 健康检查结果 ===\nHTTP状态码: %{http_code}\n总响应时间: %{time_total}s\n" http://your-service-endpoint/health || { echo "健康检查失败，详情见上方日志"; exit 7; }

• -v：输出DNS解析、TCP握手、HTTP头交换等全流程细节
• -w：自定义输出格式，明确关键指标
• 保留错误退出逻辑，但先打印提示再退出，确保错误信息被记录

3. 调整Pipeline的错误处理逻辑 #

默认的阶段失败跳转逻辑会直接跳过后续操作并触发清理，需要修改为仅在test阶段失败时执行清理，同时保留错误现场：

stage('test') {
    steps {
        sh '''
            # 插入增强后的curl命令
            curl -v -w "\n=== 健康检查结果 ===\nHTTP状态码: %{http_code}\n总响应时间: %{time_total}s\n" http://your-service-endpoint/health
        '''
    }
    post {
        failure {
            echo "Test阶段失败，执行环境清理"
            sh "./cleanup-env.sh"
        }
        success {
            echo "Test阶段验证通过，进入Deployment阶段"
        }
    }
}

如果需要强制保留所有阶段的日志，可在Pipeline顶部添加全局错误捕获：

pipeline {
    agent any
    options {
        catchError(buildResult: 'FAILURE', stageResult: 'FAILURE')
    }
    // 后续阶段定义...
}

4. 排查服务就绪与网络问题 #

Exit Code 7的常见触发原因及验证方法：

• 服务未完全启动：在curl前添加延迟或循环重试，避免过早检查：

  max_retry=5
  interval=5
  for i in $(seq 1 $max_retry); do
      if curl -s http://your-service-endpoint/health; then
          echo "服务就绪"
          exit 0
      fi
      echo "第${i}次检查失败，${interval}秒后重试"
      sleep $interval
  done
  echo "服务超时未就绪"
  exit 7
  

• 端口未正确暴露：检查容器/虚拟机的端口映射规则，确保Jenkins Agent能访问服务端口
• 网络策略限制：验证Jenkins Agent所在网络与服务网络的连通性（比如ping目标主机、telnet端口）

5. 验证修改后的日志 #

重新执行Pipeline后，你会在test阶段的日志中看到curl的完整请求流程，根据这些信息可以直接定位是DNS解析失败、TCP连接被拒绝还是服务未启动。

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