如何在GitLab中仅对特定分支执行Fast-Forward Merge？

针对你需要的特性分支→dev普通合并，dev→acceptance/acceptance→production强制Fast-Forward Merge的需求，GitLab全局设置无法满足，但可以通过以下两种方案实现：

方案一：GitLab CI/CD 管道检查（推荐，支持托管/自托管版） #

通过CI作业自动验证合并请求的合并类型，配合分支保护规则强制检查通过才能合并。

步骤： #

1. 在项目根目录创建.gitlab-ci.yml文件，添加如下检查作业：

check-fast-forward-merge:
  stage: pre-merge
  only:
    - merge_requests
  script:
    - |
      TARGET=$CI_MERGE_REQUEST_TARGET_BRANCH_NAME
      SOURCE=$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
      # 仅对acceptance和production分支启用检查
      if [[ "$TARGET" =~ ^(acceptance|production)$ ]]; then
        git fetch origin $TARGET
        git fetch origin $SOURCE
        # 获取源分支与目标分支的共同祖先
        COMMON_ANCESTOR=$(git merge-base origin/$SOURCE origin/$TARGET)
        # 验证目标分支HEAD是否等于共同祖先（即源分支是目标分支的直接后代，支持FF合并）
        if [[ "$(git rev-parse origin/$TARGET)" != "$COMMON_ANCESTOR" ]]; then
          echo "❌ 错误：合并到$TARGET必须使用Fast-Forward Merge"
          echo "请先将$TARGET分支合并到$SOURCE分支，解决冲突后重新提交合并请求"
          exit 1
        fi
      fi

2. 配置分支保护：
   • 进入项目「设置→仓库→分支保护」
   • 分别为acceptance和production分支开启「要求所有作业成功」选项，确保CI检查不通过时无法合并。

方案二：自托管GitLab预接收钩子（需服务器权限） #

如果是自托管GitLab实例，可以通过服务器端的预接收钩子直接拦截非FF推送。

步骤： #

1. 找到项目在GitLab服务器上的存储目录（通常在/var/opt/gitlab/git-data/repositories/<namespace>/<project>.git）
2. 在该目录的hooks文件夹下创建pre-receive文件，写入以下脚本：

#!/bin/bash
while read oldrev newrev refname; do
  target_branch=$(git rev-parse --symbolic --abbrev-ref "$refname")
  # 仅针对acceptance和production分支检查
  if [[ "$target_branch" == "acceptance" || "$target_branch" == "production" ]]; then
    # 验证推送是否为Fast-Forward更新
    if ! git merge-base --is-ancestor "$oldrev" "$newrev"; then
      echo "❌ 错误：推送至$target_branch必须为Fast-Forward更新"
      echo "请先拉取远程$target_branch分支，执行快进合并后再推送"
      exit 1
    fi
  fi
done
exit 0

3. 给脚本添加执行权限：

chmod +x hooks/pre-receive

注意事项 #

• 特性分支合并到dev时，由于未触发上述检查规则，可正常使用普通合并。
• 当CI或钩子检查失败时，团队成员需要先将目标分支（如acceptance）合并到源分支（如dev），解决冲突后再提交合并请求，此时即可实现Fast-Forward Merge。

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