Jenkins声明式流水线拉取SCM脚本失败时如何触发通知？

方案1：手动管控SCM拉取逻辑，结合全局流水线库 #

把SCM拉取从默认流程中剥离，手动在流水线里处理，同时将通知逻辑抽成全局可复用的库方法，这样即使拉取失败也能捕获并触发通知。

1. 先配置全局流水线库（Jenkins后台 → 系统管理 → 全局流水线库），创建一个sendNotification.groovy文件放到库的vars目录下，内容示例：

def call(String buildStatus, String message) {
  // 替换为你的实际通知逻辑，比如企业微信、邮件、Slack等
  echo "发送通知: [${buildStatus}] ${message}"
  // 示例邮件通知
  mail to: 'dev-team@example.com',
       subject: "流水线通知: ${buildStatus} - ${env.JOB_NAME} #${env.BUILD_NUMBER}",
       body: message
}

2. 修改现有流水线脚本，跳过默认SCM拉取，手动执行并捕获错误：

@Library('你的全局库名称') _

pipeline {
  agent any
  options {
    skipDefaultCheckout true // 禁用默认的SCM自动拉取
  }
  stages {
    stage('拉取代码') {
      steps {
        script {
          try {
            checkout scm // 手动执行SCM拉取
          } catch (Exception e) {
            // 拉取失败时立即触发通知
            sendNotification('FAILURE', "SCM拉取失败: ${e.getMessage()}")
            error("代码拉取失败，终止流水线") // 标记构建为失败
          }
        }
      }
    }
    // 你的其他业务阶段...
  }
  post {
    always {
      // 正常执行完成后的通知
      sendNotification(currentBuild.currentResult, "流水线执行完成")
    }
  }
}

优势：逻辑可控，和项目流水线深度绑定，能精准传递错误信息；不足：需要修改现有流水线代码。

方案2：系统级Groovy监听器全局捕获 #

通过Jenkins的构建事件监听机制，全局监控所有流水线构建，当检测到因SCM拉取失败导致的构建失败时，自动触发通知，无需修改现有流水线代码。

创建一个Groovy脚本（比如scm-failure-notifier.groovy），放到Jenkins的$JENKINS_HOME/init.groovy.d/目录下，重启Jenkins后生效：

import hudson.model.Result
import jenkins.model.Jenkins
import org.jenkinsci.plugins.workflow.job.WorkflowRun
import hudson.listeners.RunListener

def scmFailureListener = new RunListener<WorkflowRun>() {
  @Override
  void onCompleted(WorkflowRun run, hudson.model.TaskListener listener) {
    // 只处理失败的流水线构建
    if (run.result != Result.FAILURE) return

    def buildLog = run.logFile.text
    // 根据实际Git错误日志调整匹配关键词，比如"git checkout failed"、"fatal: unable to access"等
    def scmErrorPatterns = [/git checkout.*failed/, /fatal: unable to access/, /error: RPC failed/]
    
    // 检查日志是否包含SCM拉取失败的关键词
    def isScmFailure = scmErrorPatterns.any { pattern -> buildLog =~ pattern }
    if (isScmFailure) {
      // 执行通知逻辑，示例为邮件通知
      def subject = "[紧急] 流水线SCM拉取失败: ${run.fullDisplayName}"
      def body = """构建编号: ${run.number}
项目名称: ${run.parent.name}
失败日志片段:
${buildLog.substring(Math.max(0, buildLog.length() - 1500))}"""
      
      Jenkins.instance.mailer.sendMail("admin@example.com", "dev-team@example.com", subject, body)
    }
  }
}

// 注册监听器
Jenkins.instance.addListener(scmFailureListener)

优势：无需修改项目流水线，全局生效；不足：需要Jenkins管理员权限，日志匹配依赖关键词的准确性，可能误判。

方案3：使用Build Failure Analyzer插件 #

通过插件配置错误模式，自动识别SCM拉取失败的构建并触发通知，无需编写代码。

1. 安装Build Failure Analyzer插件（Jenkins后台 → 插件管理）
2. 配置错误模式（系统管理 → Build Failure Analyzer）：
   • 添加新的错误类别（比如命名为"SCM拉取失败"）
   • 添加匹配规则，比如正则表达式git checkout.*failed、fatal: unable to access等
3. 配置通知：在插件设置里勾选"当匹配到错误类别时发送通知"，或者结合Jenkins的邮件通知插件，设置当构建失败且匹配到该错误类别时发送邮件。

优势：配置简单，无代码侵入；不足：依赖日志匹配的准确性，需要维护错误规则。

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