Concourse流水线执行Maven Release插件报错：ref HEAD非符号引用

问题原因 #

Concourse的Git资源默认会以**分离头指针（detached HEAD）**的方式checkout指定的commit SHA（你的配置里明确指定了version.ref: commit-sha），而Maven Release插件在执行release:prepare时，需要当前HEAD指向一个有效的分支符号引用（也就是必须处于分支上，而非分离头状态），因此触发了这个错误。

修复方案 #

在task的执行脚本中，手动将仓库切换到目标分支并关联远程分支，确保HEAD是合法的符号引用。修改后的脚本如下：

set -e
apt-get update && apt-get install -y git
cd tool-v2
git config --global user.email "emailadd"
git config --global user.name "Service Account"

# 关键操作：切换到目标分支并关联远程上游
git checkout pipeline
git branch --set-upstream-to=origin/pipeline pipeline

# 继续执行Release流程
./mvnw release:clean release:prepare -B
./mvnw release:perform -B -Darguments="-Dmaven.javadoc.skip=true -DscmCommentPrefix='[skip ci]'"
git push --tags origin main:release

额外优化建议 #

• 如果你的流水线不需要固定到特定commit，可以移除Git资源配置中的version.ref项，让Concourse直接拉取branch: pipeline的最新提交，这样默认就会处于分支状态，无需额外切换分支的操作。
• 若必须固定到特定commit，上述脚本中的分支切换步骤是必不可少的，它会基于当前checkout的commit创建本地分支并关联远程，满足Maven Release的要求。

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