Jenkins通知发送至错误提交ID问题咨询

我之前也踩过一模一样的坑——共享库加载后，插件误把共享库的提交ID当成项目仓库的来发通知，导致状态全跑到共享库仓库里去了。下面几个方法亲测有效：

方法1：提前锁定项目提交ID，强制覆盖环境变量 #

有些版本的Bitbucket构建状态插件会默认读取GIT_COMMIT环境变量，但共享库加载过程中这个变量可能被意外覆盖。你可以在流水线最开头就把项目的实际提交ID存下来，发送通知前再强制重置回去：

// 流水线启动后第一时间保存项目的真实提交ID
def projectCommitId = env.GIT_COMMIT

// 加载共享库（不管是隐式还是显式加载都不影响）
@Library('your-shared-library') _

// 发送通知前重置环境变量为项目提交ID
stage('Notify Bitbucket') {
  steps {
    script {
      env.GIT_COMMIT = projectCommitId
      bitbucketStatusNotify(buildState: 'SUCCESS') // 替换成你需要的状态
    }
  }
}

核心逻辑就是先把项目的提交ID“存起来”，避免共享库加载时干扰这个变量。

方法2：直接调用Bitbucket REST API（最可靠） #

如果插件的局限性实在绕不开，直接用Bitbucket的API发送状态通知反而更灵活，完全不受共享库的影响。只需要提前确认项目仓库的信息、提交ID，再配合Jenkins的凭证即可：

stage('Notify Bitbucket via API') {
  steps {
    script {
      def bitbucketApiUrl = 'https://your-bitbucket-domain/rest/api/1.0'
      def projectKey = 'YOUR_PROJECT_KEY' // Bitbucket里的项目键
      def repoSlug = 'your-project-repo-slug' // 项目仓库的slug
      def commitId = env.GIT_COMMIT // 确保这个是项目的提交ID
      def buildState = 'SUCCESSFUL' // 可选值：SUCCESSFUL、FAILED、INPROGRESS
      def buildUrl = env.BUILD_URL

      // 用Jenkins凭证存储的Bitbucket账号和App Password
      withCredentials([usernamePassword(credentialsId: 'bitbucket-app-pass', usernameVariable: 'BB_USER', passwordVariable: 'BB_PASS')]) {
        sh """
          curl -u ${BB_USER}:${BB_PASS} -X POST \
          ${bitbucketApiUrl}/projects/${projectKey}/repos/${repoSlug}/commits/${commitId}/builds \
          -H "Content-Type: application/json" \
          -d '{
            "state": "${buildState}",
            "key": "${env.JOB_NAME}",
            "name": "${env.BUILD_DISPLAY_NAME}",
            "url": "${buildUrl}",
            "description": "Jenkins构建状态：${buildState}"
          }'
        """
      }
    }
  }
}

这个方法完全绕过插件，你可以精准控制要发送的提交ID和目标仓库，再也不会被共享库干扰。

方法3：检查流水线执行顺序和共享库配置 #

最后再排查两个细节：

• 确保项目代码拉取在共享库加载之前：如果你的流水线先加载共享库再拉项目代码，GIT_COMMIT还没被设置，插件就会误读共享库的提交ID。正确顺序应该是：拉项目代码 → 保存提交ID → 加载共享库 → 构建 → 发通知。
• 全局共享库配置：如果用的是全局共享库，在Jenkins配置里勾选Allow overriding this library in the pipeline，然后在项目流水线里显式指定分支/标签（比如@Library('your-lib@main') _），避免插件读取共享库的HEAD提交。

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