GitLab CI/CD流水线未正确检测文件变更问题排查求助

一、解决「git命令未找到」错误 #

• 默认GitLab Runner镜像（如alpine:latest）可能未预装git，导致脚本中执行git命令失败
• 修复方案：
  1. 在job的before_script中安装git：
     • 若用alpine镜像：apk add --no-cache git
     • 若用debian/ubuntu镜像：apt-get update && apt-get install -y git
  2. 直接改用预装git的官方镜像，比如image: alpine/git或image: python:latest这类自带git的基础镜像

二、解决「未检测到文件变更」问题 #

1. 取消浅克隆限制 #

GitLab CI默认使用浅克隆（仅拉取最近1次提交），无法获取完整历史来对比文件变更。在.gitlab-ci.yml中添加变量取消浅克隆：

variables:
  GIT_DEPTH: 0  # 完整克隆仓库，允许对比历史提交的文件变更

2. 验证文件路径匹配 #

确认你指定的文件路径与仓库实际路径完全一致，可在job的script中手动打印变更文件列表，排查匹配规则：

git diff --name-only $CI_COMMIT_BEFORE_SHA $CI_COMMIT_SHA

将输出结果与你在changes字段中配置的路径对比，修正路径错误。

3. 检查分支触发规则 #

确保你在only/refs中正确指定了dev和prod分支，避免分支匹配错误导致变更检测失效。

三、验证跨仓库触发配置 #

确保触发Exp仓库指定分支的配置正确，示例如下：

trigger_exp_pipeline:
  stage: trigger
  only:
    refs:
      - dev
      - prod
    changes:
      - path/to/target-file1.yaml
      - path/to/target-file2.conf
  before_script:
    - apk add --no-cache git  # 按需安装git
  script:
    - git diff --name-only $CI_COMMIT_BEFORE_SHA $CI_COMMIT_SHA  # 调试用，可删除
  trigger:
    project: your-group/Exp
    branch: feature/ABC-123-Server-Update-Component-And-Unit-Test
    variables:
      SOURCE_BRANCH: $CI_COMMIT_BRANCH  # 传递原分支信息

额外检查项 #

• 确认GitLab Runner有权限访问Exp仓库，且配置了足够的流水线触发权限
• 若使用私有Runner，检查Runner的执行环境是否有网络或权限限制，导致无法拉取完整仓库或触发远程流水线

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