如何在Jenkins脚本化流水线中处理Git推送失败的异常？

安全阿岳

2026-7-8

Jenkins脚本化流水线：处理推送失败的错误捕获问题

Jenkins脚本化流水线中，默认情况下，多数步骤（包括shell执行的Git推送命令）失败时会直接触发流水线的「失败」状态并终止当前执行流程，不会抛出可被try/catch捕获的异常——这就是你遇到推送被拒绝时catch块不生效的核心原因。以下是几种可行的解决方式：

方案一：用`catchError`包裹步骤，将失败转为可捕获异常

通过catchError可以强制让步骤失败后不直接终止流水线，而是将错误传递给try/catch块处理：

node {
  try {
    catchError(buildResult: 'FAILURE', stageResult: 'FAILURE') {
      // 执行Git推送操作，这里以shell命令为例
      sh 'git push origin HEAD:develop'
    }
  } catch (any) {
    // 推送失败时执行PR发起逻辑，示例用GitHub CLI命令
    sh 'gh pr create --base develop --head ${env.BRANCH_NAME} --title "Auto PR: ${env.BRANCH_NAME} → develop"'
  }
}

catchError的参数可以控制流水线和阶段的最终状态，确保失败被标记的同时，流程能进入catch块执行后续操作。

方案二：手动检查命令退出码，不依赖异常捕获

使用sh步骤的returnStatus: true参数，让命令失败时不终止流水线，而是返回退出码，通过判断退出码来执行后续逻辑：

node {
  // 执行Git推送，获取退出码
  def pushExitCode = sh script: 'git push origin HEAD:develop', returnStatus: true

  // 退出码非0说明推送失败，执行PR逻辑
  if (pushExitCode != 0) {
    sh 'gh pr create --base develop --head ${env.BRANCH_NAME} --title "Auto PR: ${env.BRANCH_NAME} → develop"'
  }
}

这种方式更直观，不需要依赖异常捕获机制，适合简单的失败判断场景。