Git update钩子未接收参数问题排查求助

看起来你遇到的核心问题是update钩子没接收到预期的三个参数，我来帮你排查几个最常见的原因：

1. 钩子放错了位置——update是服务器端钩子 #

Git的update钩子是运行在远程仓库上的，不是你本地的开发仓库！很多新手会误把钩子文件放到本地.git/hooks目录下，这完全没用，因为git push操作触发的是远程仓库的钩子逻辑。

你需要把这个脚本复制到远程仓库的hooks目录下（如果是裸仓库，路径类似/path/to/remote/repo.git/hooks/），并且把文件名改成update（去掉默认的.sample后缀）。

2. 钩子没有可执行权限 #

Git只会执行拥有可执行权限的钩子脚本，所以你需要在远程仓库上给脚本加上执行权限：

chmod +x /path/to/remote/repo.git/hooks/update

如果缺少这个权限，Git可能会直接跳过钩子执行，或者执行时出现异常导致参数无法正常传递。

3. （少见情况）远程Git版本过于老旧 #

虽然概率很低，但某些非常老旧的Git版本可能在钩子参数传递上存在bug。你可以在远程仓库执行git --version查看版本，建议升级到2.0以上的稳定版本。

验证调试方法 #

修改你的钩子脚本，增加更详细的调试日志，方便排查：

#!/bin/bash
# 输出到远程仓库的临时日志文件，方便查看
echo "=== Update Hook Debug Log ===" >> /tmp/git_update_hook.log
echo "Timestamp: $(date)" >> /tmp/git_update_hook.log
echo "Args received: $@" >> /tmp/git_update_hook.log
echo "Refname: $1, Oldrev: $2, Newrev: $3" >> /tmp/git_update_hook.log

执行git push后，登录远程服务器查看/tmp/git_update_hook.log的内容，就能明确钩子是否被执行，以及参数传递的情况。

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