如何配置Git服务器端pre-receive钩子？含常见问题排查

看起来你已经理清了客户端和服务器端钩子的核心区别，但在部署服务器端钩子时踩了几个常见的坑，我来一步步帮你解决：

一、先纠正核心认知：服务器端钩子不能通过Git推送部署 #

你之前把pre-receive钩子推送到master分支的做法是错误的——Git服务器仓库的hooks目录（裸仓库直接是hooks/，非裸仓库是.git/hooks）不属于仓库的版本控制内容，推送上去的钩子文件根本不会被服务器识别。服务器端钩子必须手动部署到服务器的仓库目录里。

二、正确部署pre-receive钩子的步骤 #

1. 登录Git服务器，找到目标仓库的物理路径（比如裸仓库通常在/var/git/repos/your-project.git/这类路径下）。
2. 进入仓库的hooks目录（如果是新创建的仓库，这个目录里会有很多.sample示例文件）。
3. 创建无后缀的pre-receive文件，把你的验证脚本内容写入其中。
4. 关键步骤：添加可执行权限，执行命令：

   chmod +x pre-receive
   

   不管是Linux还是Windows平台（Windows上可以用Git Bash或者WSL执行这个命令，或者在文件属性里设置执行权限），这一步都不能少，否则钩子会无法触发。

三、解决你遇到的具体问题 #

1. Windows平台报错：error: cannot spawn hooks/pre-receive: No such file or directory #

这个错误大概率是两个原因：

• 钩子文件没放在服务器仓库的hooks目录下：你之前放在本地的git_hooks或.git/hooks，或者推送到远程分支的钩子，服务器根本找不到。
• 换行符不兼容：如果你的脚本是在Windows编辑器里写的，默认是CRLF换行符，而Git服务器（即使是Windows环境）可能期望LF换行符。可以用编辑器把换行符改成LF，或者用dos2unix pre-receive命令转换。

2. Linux平台钩子未触发 #

最常见的原因就是没给钩子加可执行权限，执行chmod +x pre-receive后再测试。另外要确保脚本开头指定了正确的解释器，比如bash脚本开头必须有#!/bin/bash，Python脚本要有#!/usr/bin/env python3，否则服务器不知道用什么程序来执行你的脚本。

四、git push时服务器端钩子的触发流程 #

当你执行git push时，服务器端的触发逻辑是这样的：

1. 客户端和服务器建立连接，推送本地的提交对象到服务器。
2. 服务器首先触发pre-receive钩子——它会接收所有待推送的引用（分支、标签等）的信息（旧提交哈希、新提交哈希、引用名称）。
3. 如果pre-receive钩子返回非0值，整个推送会被直接拒绝；返回0则继续执行后续的update钩子（针对每个单独的引用做更细粒度的检查），最后执行post-receive钩子（用来做推送完成后的通知、部署等操作）。

五、写pre-receive钩子的实用示例 #

比如你要验证推送到master分支的文件，这里给你一个bash脚本的简单框架：

#!/bin/bash

# 循环读取推送的引用信息
while read old_commit new_commit ref; do
    # 判断是否是推送到master分支
    if [[ "$ref" == "refs/heads/master" ]]; then
        # 获取新旧提交之间改动的所有文件
        changed_files=$(git diff --name-only "$old_commit" "$new_commit")
        # 遍历文件执行你的验证逻辑
        for file in $changed_files; do
            # 替换成你的实际验证命令，比如语法检查、合规性校验等
            if ! your-validation-command "$file"; then
                echo "❌ 文件 $file 验证失败，推送已被拒绝"
                exit 1
            fi
        done
    fi
done

# 所有验证通过，允许推送
exit 0

注意：服务器端的钩子运行在服务器的系统环境里，要确保脚本里用到的验证工具已经在服务器上安装并能正常调用。

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