在Docker中运行Githooks执行git add时遭遇index.lock问题

问题根源 #

执行git commit时，宿主机的Git进程会创建.git/index.lock锁文件保护索引，防止并发修改。而Docker容器内的Git是独立进程，尝试修改同一索引时，会因宿主机Git已持有锁而无法创建新锁，导致报错。

解决方案 #

1. 让容器复用宿主机的Git进程 #

直接在容器内调用宿主机的Git命令，避免跨进程的锁冲突：
修改pre-commit钩子的Docker运行命令，挂载宿主机的Git二进制到容器：

docker run --rm -v "$(pwd):/workspace" -v "$(which git):/usr/bin/git" -w "/workspace" myimage:1.0.0 bash script.sh

这样容器内执行git add .时，实际调用的是宿主机的Git进程，和git commit共享同一锁上下文，不会触发冲突。

2. 等待宿主机Git锁释放后再执行操作 #

在容器内的script.sh中添加等待逻辑，等宿主机的Git锁释放后再执行git add .：

# 等待index.lock释放，最多等待30秒
MAX_WAIT=30
WAIT_COUNT=0
while [ -f .git/index.lock ] && [ $WAIT_COUNT -lt $MAX_WAIT ]; do
    sleep 1
    WAIT_COUNT=$((WAIT_COUNT+1))
done

if [ $WAIT_COUNT -eq $MAX_WAIT ]; then
    echo "等待Git锁超时，终止操作"
    exit 1
fi

git add .

这个方法通过等待避免直接冲突，比强制删除锁更安全，但要注意设置合理的超时时间。

3. 以宿主机用户身份运行容器 #

容器默认以root用户运行，可能因权限问题无法正确识别宿主机Git创建的锁文件。修改Docker命令，让容器以宿主机当前用户的UID/GID运行：

docker run --rm -v "$(pwd):/workspace" -w "/workspace" --user "$(id -u):$(id -g)" myimage:1.0.0 bash script.sh

这样容器内进程的权限和宿主机用户一致，既能正确访问锁文件状态，也能避免后续文件权限问题。

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