GitLab CI/CD中获取合并请求多提交变更文件失败求助

问题根源 #

CI_MERGE_REQUEST_SOURCE_BRANCH_NAME这类合并请求专属变量仅在合并请求触发的流水线中才会被GitLab自动注入。如果你的流水线是手动触发分支流水线、定时流水线或其他非MR触发的类型，这些变量会是空值，进而导致后续的git diff命令无法生成有效结果。

可行解决方案 #

1. 确保流水线由合并请求触发 #

• 不要直接在分支页面手动启动流水线，必须进入合并请求详情页，找到「流水线」选项卡启动对应流水线。
• 可以在.gitlab-ci.yml中给目标job添加触发规则，限定只有MR触发时才运行，避免无效执行：

diff_job:
  variables:
    GIT_STRATEGY: clone
    GIT_DEPTH: 0
  script:
    - echo $CI_COMMIT_REF_NAME
    - echo $CI_MERGE_REQUEST_SOURCE_BRANCH_NAME
    - git fetch origin
    - export CHANGED_FILES=$(git diff --name-only origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME...origin/$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME)
    - echo "All changed files are below"
    - echo "${CHANGED_FILES}"
  only:
    - merge_requests

2. 修正git diff对比逻辑 #

原命令的两点对比会拉取两个分支的全量提交差异，改用三点对比更适合获取MR中相对于目标分支的实际变更（排除目标分支后续新增的无关提交）。同时要先拉取所有分支的最新代码，避免本地代码过时：

- git fetch origin
- export CHANGED_FILES=$(git diff --name-only origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME...origin/$CI_MERGE_REQUEST_SOURCE_BRANCH_NAME)

3. 排查变量注入状态 #

如果问题依旧，先在脚本中添加变量排查命令，确认MR相关变量是否正常注入：

- env | grep CI_MERGE_REQUEST

若输出为空，说明当前流水线并非MR触发，需调整触发方式。

4. 备选方案：用提交SHA对比 #

如果MR变量无法正常获取（如特殊场景限制），可以用GitLab提供的CI_COMMIT_BEFORE_SHA和CI_COMMIT_SHA对比当前提交的变更——注意这仅能获取单次提交的文件，而非整个MR的所有变更：

- export CHANGED_FILES=$(git diff --name-only $CI_COMMIT_BEFORE_SHA $CI_COMMIT_SHA)

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