Git钩子无法自动运行求助：配置post-receive触发Jenkins构建失败

以下是几个你可能没排查到的关键点，按顺序检查：

• 确认shebang行正确
  钩子脚本的第一行必须指定解释器，比如bash脚本开头要写#!/bin/bash，如果省略或者路径错误（比如系统里bash在/usr/bin/bash而不是/bin/bash），系统无法识别脚本类型，会直接跳过执行。

• 检查钩子的所有者与权限细节
  除了chmod ug+x，建议直接设置chmod 755 post-receive确保所有用户都有读和执行权限。同时要确认钩子文件的所有者是Git仓库的运行用户（比如服务器上的git用户），如果文件属于root但Git用普通用户运行，会因为权限不足无法执行。

• 确认钩子部署在正确的仓库
  post-receive是服务器端钩子，只能在你push目标的远程仓库（比如Git服务器上的裸仓库）的.git/hooks目录下生效，本地仓库的钩子不会在push时触发。如果你是在本地仓库配置的，赶紧把脚本移到远程仓库对应目录。

• 验证core.hooksPath配置
  执行git config --local --get core.hooksPath查看实际生效的路径，确保它指向的是你存放钩子的目录（比如远程仓库的.git/hooks）。如果是相对路径，要确认是相对于仓库根目录的路径，建议直接用绝对路径设置：git config --local core.hooksPath /var/repos/my-project.git/hooks。

• 添加日志排查脚本错误
  在钩子脚本最开头添加日志输出代码，把执行过程和错误记录下来：

  exec >> /var/log/git-post-receive.log 2>&1
  echo "Hook started at $(date)"
  

  执行push后查看日志，如果有日志生成说明钩子已经执行，只是脚本内部有问题（比如调用Jenkins API时参数错误、网络不通）；如果没有日志，才是钩子没被触发。

• 检查服务器安全模块限制
  若你的Git仓库在Linux服务器上，SELinux或AppArmor这类安全模块可能会阻止Git执行钩子。可以临时关闭SELinux测试：setenforce 0，如果钩子能正常运行了，就需要添加SELinux规则允许Git执行该目录下的脚本。

• 确认远程仓库是裸仓库
  Git默认不会在非裸仓库（有工作区的仓库）触发post-receive钩子，因为push到非裸仓库可能会导致工作区文件不一致。远程仓库必须是用git init --bare创建的裸仓库。

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