Ubuntu服务器Post Update Git Hook无法执行问题求助

1. 确认仓库类型：必须是裸仓库 #

git的post-update钩子仅在裸仓库（bare repository）中会被推送触发。如果你的服务器仓库是带有工作目录的普通仓库：

• 先检查是否允许推送到当前分支：运行git config receive.denyCurrentBranch，如果输出是refuse，则推送会被直接拒绝，钩子根本不会执行。
• 推荐转为裸仓库：

  # 备份原仓库后，转为裸仓库
  git config --bool core.bare true
  # 或者重新初始化一个裸仓库
  git init --bare /path/to/new-bare-repo
  

2. 确保钩子文件拥有可执行权限 #

git只会执行具备可执行权限的钩子脚本，即使内容正确，没有权限也不会运行：

cd <repo-root>
chmod +x .git/hooks/post-update

3. 修正日志文件的绝对路径 #

脚本中用相对路径post-update.log时，日志会生成在git仓库的当前工作目录（裸仓库根目录/普通仓库工作区根目录），可能不是你预期的位置。改为绝对路径并捕获错误：

#!/bin/sh
echo "POST-UPDATE triggered at $(date)" >> /full/path/to/repo-root/post-update.log 2>&1

2>&1会把错误信息也写入日志，方便排查脚本执行时的报错。

4. 验证钩子触发的分支范围 #

post-update会在推送任何分支时触发，可在脚本中添加分支参数输出，确认是否是main分支触发：

#!/bin/sh
echo "POST-UPDATE triggered for branches: $* at $(date)" >> /full/path/to/log 2>&1

推送后查看日志，确认$*中包含refs/heads/main。如果服务器默认分支是master而非main，需对应调整推送分支。

5. 手动测试钩子脚本 #

直接在服务器上手动运行钩子，模拟推送触发场景，验证脚本本身是否正常：

cd <repo-root>
./.git/hooks/post-update refs/heads/main

若此时能生成日志，说明钩子本身没问题，问题出在推送触发环节；若仍无日志，检查脚本语法、日志目录的写入权限。

6. 普通仓库的特殊配置（不推荐） #

如果要保留普通仓库的工作目录，需配置允许推送到当前分支：

git config receive.denyCurrentBranch updateInstead

但这种方式稳定性不如裸仓库，更推荐用裸仓库作为推送目标，再在post-update钩子中拉取代码到工作目录。

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