Maven release:prepare未使用指定标签名（GitHub Action环境）

以下是针对性的排查和解决步骤：

1. 确保变量在GitHub Action中正确传递 #

你当前在shell中定义的tagName变量，可能因GitHub Action的step作用域问题，未能正确传递到后续Maven命令。可将变量导出为工作流环境变量：

# Determine tag name
echo "Test"
tagName=${{ tagName }}
if [ -z "$tagName" ]; then
  tagName=$baseVersion
fi
echo "Using tag name: $tagName"
# 导出为环境变量，确保后续命令能读取到
echo "tagName=$tagName" >> $GITHUB_ENV

之后在Maven命令中使用环境变量引用：

mvn $MAVEN_OPTS release:prepare \
  $releaseVersionParam \
  -DdevelopmentVersion="$developmentVersion" \
  -Dtag="${{ env.tagName }}" \
  --no-transfer-progress \
  -B -U -X

2. 检查pom.xml中的Release插件配置 #

如果你的pom.xml里配置了tagNameFormat，该配置会强制覆盖命令行指定的标签名。比如以下配置会让插件始终用项目版本作为标签：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-release-plugin</artifactId>
  <version>你的插件版本</version>
  <configuration>
    <tagNameFormat>@{project.version}</tagNameFormat>
  </configuration>
</plugin>

解决方法：删除tagNameFormat配置，或修改为你需要的格式（比如v@{project.version}），这样命令行的-Dtag参数才能生效。

3. 使用正确的命令行参数指定标签 #

Maven Release插件的release:prepare目标，正确的标签指定参数是-Dtag，而非-DscmReleaseLabel。scmReleaseLabel是插件内部参数，命令行直接用-Dtag才能正确覆盖默认标签名。

4. 确认工作流权限 #

确保GitHub Action工作流拥有创建标签的权限，在工作流开头添加：

permissions:
  contents: write

没有写权限的话，插件无法将自定义标签推送到远程仓库，可能导致你看到的是插件默认生成的版本号标签。

5. 调试变量值 #

在执行Maven命令前，打印所有相关变量确认值是否正确：

echo "当前tagName: $tagName"
echo "releaseVersionParam: $releaseVersionParam"
echo "developmentVersion: $developmentVersion"

如果变量值不符合预期，需先排查变量赋值逻辑的问题。

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