在GitHub Actions执行Maven Gitflow发布时遇拒绝合并无关历史错误

错误原因 #

这个Git错误的核心是：要合并的分支（比如release分支与develop/master分支）没有共同的提交历史，Git默认拒绝这种无关联历史的合并操作。在GitHub Actions环境中，最常见的诱因是浅克隆导致历史不完整，其次是仓库分支本身存在历史脱节，或是GitFlow插件配置问题。

解决方案 #

1. 确保克隆完整仓库历史 #

GitHub Actions默认的actions/checkout仅拉取最近1次提交（浅克隆），这会导致GitFlow无法获取完整的分支/标签历史，进而触发无关历史的合并错误。修改checkout步骤，拉取全量历史：

- name: Checkout full repository history
  uses: actions/checkout@v4
  with:
    fetch-depth: 0  # 拉取所有历史提交
    fetch-tags: true  # 拉取所有标签

2. 修复分支历史脱节问题 #

如果仓库的develop和主分支（master/main）确实无关联历史，需先手动合并并允许无关历史：

# 拉取所有分支
git fetch --all
# 切换到develop分支
git checkout develop
# 强制合并主分支，允许无关历史
git merge <main|master> --allow-unrelated-histories
# 解决合并冲突后提交
git add .
git commit -m "Merge unrelated histories from main/master"
# 推送到远程仓库
git push origin develop

完成后再在GitHub Actions中执行GitFlow发布命令。

3. 检查并更新GitFlow Maven插件 #

旧版本的GitFlow插件可能存在分支处理bug，确保使用最新稳定版，并配置正确的分支名称（比如仓库主分支是main而非默认的master）：
在项目的pom.xml中更新插件配置：

<build>
  <plugins>
    <plugin>
      <groupId>com.amashchenko.maven.plugin</groupId>
      <artifactId>gitflow-maven-plugin</artifactId>
      <version>1.14.0</version> <!-- 替换为最新稳定版 -->
      <configuration>
        <masterBranch>main</masterBranch> <!-- 匹配你的主分支名称 -->
        <developBranch>develop</developBranch>
      </configuration>
    </plugin>
  </plugins>
</build>

4. 配置CI环境的Git身份 #

GitHub Actions环境中需正确配置Git用户信息，避免提交失败间接引发历史问题：

- name: Configure Git identity
  run: |
    git config --global user.name "GitHub Actions Bot"
    git config --global user.email "actions@github.com"

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