GitLab流水线运行pre-commit报git失败错误的解决咨询

我在GitLab流水线中运行pre-commit工具，使用已安装Git的自定义Python镜像。任务启动时通过pip安装pre-commit，已将pre-commit及其依赖添加到$PATH，执行git version可正常检测到Git，但任务运行时出现错误：

An error has occurred: FatalError: git failed. Is it installed, and are you in a Git repository directory?

对应的GitLab YAML配置：

lint.precommit:
  image: ${CI_REGISTRY}/containers/python:v1.0.0
  stage: lint
  rules:
  - if: '$CI_PIPELINE_SOURCE == "push"'
  - when: never
  variables:
    PRE_COMMIT_HOME: ${CI_PROJECT_DIR}/.cache/pre-commit
  before_script:
  - pip install pre-commit --break-system-packages
  - export PATH=/home/python/.local/bin:$PATH
  script:
  - git version
  - pre-commit run --all
  cache:
    paths:
    - ${PRE_COMMIT_HOME}

流水线启动时的Git初始化输出：

Getting source from Git repository
Fetching changes with git depth set to 20...
Initialized empty Git repository in /builds/renovate/.git/
Created fresh repository.
Checking out c96e0361 as detached HEAD (ref is main)...
Skipping Git submodules setup

当前处于Git仓库目录中，但无法定位错误原因。

更新
本地运行该Python镜像时，执行type git输出：git is a tracked alias for /usr/bin/git；执行echo $PATH输出：/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin。

这个错误的核心原因是pre-commit无法识别shell环境中的Git别名，结合镜像中Git为tracked alias的情况，可通过以下方式解决：

• 指定pre-commit使用的Git可执行文件路径
  在流水线的before_script中添加环境变量，强制pre-commit调用Git的实际路径：

  export PRE_COMMIT_GIT_EXECUTABLE=/usr/bin/git
  

  或者直接在执行pre-commit时指定参数：

  pre-commit run --all --git-executable=/usr/bin/git
  

• 修改镜像，替换Git别名为软链接
  如果有权限修改自定义Python镜像，将Git的别名替换成软链接，让pre-commit能直接找到可执行文件：

  unalias git
  ln -s /usr/bin/git /usr/local/bin/git
  

• 调整PATH优先级
  在before_script中调整PATH顺序，让Git实际路径所在的/usr/bin优先级高于可能存在别名的路径：

  export PATH=/usr/bin:$PATH
  

• 验证Git实际路径可用性
  在流水线的script中先执行Git实际路径的版本检查，确认路径有效：

  /usr/bin/git version
  

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