自定义Git pre-receive hook失败后，如何实现强制推送？

我之前也碰到过一模一样的需求——既要用pre-receive hook把关提交质量，又得给开发者留个紧急情况下强制推送的口子。其实解决思路很简单：在你的Shell脚本里加一段逻辑，识别出强制推送的操作，让这类请求直接放行就行。

核心原理：识别强制推送的特征 #

Git的pre-receive hook会从标准输入获取每一条推送的引用信息，格式是：

旧提交ID 新提交ID 引用名

强制推送（通常是git push --force或--force-with-lease）本质是非快进式推送——新提交的内容不在旧提交的历史分支上。我们可以利用git rev-list命令判断这种场景：如果新提交不是旧提交的后代，就判定为强制推送。

修改你的pre-receive脚本 #

直接在原有脚本里加入强制推送的判断逻辑，示例如下：

#!/bin/bash

# 遍历每一条推送的引用记录
while read oldrev newrev refname; do
    # 跳过新建分支的情况（旧提交ID全为0）
    if [ "$oldrev" = "0000000000000000000000000000000000000000" ]; then
        continue
    fi

    # 判断是否为非快进推送（即强制推送）
    # git rev-list --quiet 会检查新提交是否在旧提交的历史中，非快进则返回非0值
    if ! git rev-list "$oldrev".."$newrev" --quiet; then
        # 检测到强制推送，直接放行
        echo "检测到强制推送，跳过提交检查" >&2
        exit 0
    fi

    # --------------------------
    # 下面是你原有的提交检查逻辑
    # 比如检查提交信息格式、敏感内容、代码规范等
    # 示例：检查提交信息是否包含JIRA单号
    # commit_msg=$(git log --format=%B -n 1 "$newrev")
    # if ! echo "$commit_msg" | grep -q "PROJ-[0-9]*"; then
    #     echo "错误：提交信息必须包含JIRA单号（如PROJ-123）" >&2
    #     exit 1
    # fi
    # --------------------------

done

# 默认放行所有符合要求的推送
exit 0

进阶：限制强制推送的范围 #

如果你不想让所有强制推送都绕过检查，可以再加一层限制，比如：

• 只允许特定分支（如main/master）的强制推送
• 只允许特定用户（如管理员）执行强制推送

示例1：只允许main分支的强制推送

if [ "$refname" = "refs/heads/main" ] && ! git rev-list "$oldrev".."$newrev" --quiet; then
    echo "允许main分支的强制推送" >&2
    exit 0
fi

示例2：只允许管理员账号的强制推送

GitLab会给pre-receive hook注入环境变量GL_USERNAME，你可以用它判断当前推送用户：

if [ "$GL_USERNAME" = "admin_user" ] && ! git rev-list "$oldrev".."$newrev" --quiet; then
    echo "管理员强制推送，跳过检查" >&2
    exit 0
fi

最后检查 #

修改完脚本后，别忘了：

1. 给脚本设置可执行权限：chmod +x pre-receive
2. 确保脚本放在GitLab项目的custom_hooks目录下（路径通常是/var/opt/gitlab/git-data/repositories/<namespace>/<project>.git/custom_hooks/，具体路径可根据你的GitLab部署调整）

这样调整后，开发者用git push --force就能绕过你的提交检查，正常推送依然会被拦截。

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