Gitolite服务器自动拉取Git仓库生成文档脚本故障排查

核心原因 #

Gitolite钩子的运行环境与你直接登录服务器的环境存在差异，大概率是Git版本过低不支持-C参数，或者钩子环境中调用的Git版本和你本地登录时使用的版本不一致。早期Git版本（1.8.5之前）没有-C选项，会导致该参数被忽略，Git依然在当前工作目录（钩子运行的目录，并非你指定的repodir）查找仓库，从而报错。

解决方案 #

方案1：替换git -C为cd+git pull（最兼容）

修改脚本中git -C "$repodir" pull这一行，改为先进入目标目录再执行pull，避免依赖-C参数：

cd "$repodir" && git pull

修改后的脚本对应部分：

if test -d "${repodir}/.git"; then
    cd "$repodir" && git pull
else
    echo "no .git in ${repodir}?"
fi

方案2：指定Git绝对路径并验证版本

1. 先在服务器上查找到Git的绝对路径（登录后执行which git，比如得到/usr/local/bin/git）
2. 在脚本中使用绝对路径调用Git，同时可以先验证版本：

# 可选：先打印Git版本，排查环境差异
echo "Git version: $(/usr/local/bin/git --version)"
/usr/local/bin/git -C "$repodir" pull

如果版本低于1.8.5，建议升级Git，或者直接采用方案1。

方案3：确保钩子环境的PATH正确

在脚本开头添加PATH设置，确保使用和你登录时相同的Git：

#!/bin/bash
set -x
# 添加你的Git所在路径到PATH，比如
export PATH="/usr/local/bin:$PATH"

验证方法 #

修改脚本后，提交代码触发Gitolite钩子，查看错误日志是否消失。如果还是有问题，可以在脚本中添加pwd和echo $PATH命令，对比钩子运行时和本地登录时的工作目录、环境变量差异，进一步排查。

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