git-commit-id-plugin在Jenkins构建中git.branch显示为提交ID的问题

问题原因 #

Jenkins执行Git拉取时，默认采用**分离头指针（detached HEAD）**模式：它只会拉取触发构建的特定提交哈希，不会在本地创建或切换到对应分支。这种情况下，git-commit-id-plugin无法从Git仓库中识别出有效分支名称，只能将提交哈希值填充到git.branch字段中。

解决方案 #

方法1：调整Jenkins的Git拉取设置 #

在Jenkins项目的构建配置里找到Git相关设置：

• 勾选 "Checkout to specific local branch" 选项
• 输入框填写${GIT_BRANCH}（Jenkins会自动替换为触发构建的分支名）

这样Jenkins构建时会切换到对应分支，而非保持detached HEAD状态，插件就能正确识别分支名称。

方法2：配置git-commit-id-plugin的分支检测参数 #

在插件的<configuration>块中添加以下参数，强制插件从Git远程信息解析分支：

<configuration>
  <!-- 保留原有配置 -->
  <dotGitDirectory>${project.basedir}/../../.git</dotGitDirectory>
  <generateGitPropertiesFile>true</generateGitPropertiesFile>
  <generateGitPropertiesFilename>src/main/resources/git.properties</generateGitPropertiesFilename>
  
  <!-- 新增配置 -->
  <useNativeGit>true</useNativeGit>
  <branchDetectionMode>FULL</branchDetectionMode>
  <includeBranchName>true</includeBranchName>
</configuration>

• useNativeGit：使用本地Git命令代替JGit获取信息，兼容性更强
• branchDetectionMode=FULL：启用完整分支检测逻辑，包含从远程引用推断分支
• includeBranchName：明确要求插件输出分支名称信息

方法3：通过Jenkins环境变量传递分支名 #

如果前两种方法无效，可以直接在Jenkins构建时把分支名作为系统属性传给Maven：
Jenkins的Maven构建命令修改为：

mvn clean install -Dgit.branch=${GIT_BRANCH}

同时在插件配置里添加<overrideExistingGitProperties>true</overrideExistingGitProperties>，允许系统属性覆盖自动生成的值：

<configuration>
  <!-- 保留原有配置 -->
  <overrideExistingGitProperties>true</overrideExistingGitProperties>
</configuration>

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