GitLab CI基于CI_PIPELINE_SOURCE的规则不生效问题求助

核心规则配置 #

要实现仅在合并请求（MR）事件或MR源分支的后续推送时触发Job，需借助GitLab内置预定义变量，通过rules精准控制触发逻辑：

# 示例Job配置，替换成你的实际Job名称
target_job:
  script:
    - echo "仅在MR或MR源分支推送时执行"
  rules:
    # 匹配所有合并请求事件（创建、更新、重跑MR都会触发）
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      when: always
    # 匹配存在开放MR的分支推送（即MR源分支的后续代码提交）
    - if: '$CI_COMMIT_BRANCH && $CI_OPEN_MERGE_REQUESTS'
      when: always
    # 兜底规则：其他所有情况都不触发
    - when: never

关键变量说明 #

• $CI_PIPELINE_SOURCE == "merge_request_event"：精准锁定MR专属流水线，避免和普通push流水线混淆
• $CI_OPEN_MERGE_REQUESTS：当前推送的分支若关联了未关闭的MR，该变量会返回非空值，以此判断是否为MR源分支的后续推送

排除特定文件误触发 #

如果需要进一步排除仅修改.gitlab-ci.yml或awe/src/test-file.sh时的流水线触发（即使满足上述规则），可添加文件路径过滤：

target_job:
  script:
    - echo "仅在MR或MR源分支推送时执行（排除指定文件单独修改）"
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      changes:
        - "**/*"
        - "!.gitlab-ci.yml"
        - "!awe/src/test-file.sh"
      when: always
    - if: '$CI_COMMIT_BRANCH && $CI_OPEN_MERGE_REQUESTS'
      changes:
        - "**/*"
        - "!.gitlab-ci.yml"
        - "!awe/src/test-file.sh"
      when: always
    - when: never

常见问题排查 #

1. 规则顺序错误：GitLab按rules定义顺序匹配，必须将when: never放在最后作为兜底，否则会触发默认的自动运行逻辑
2. 变量引用错误：确保变量用单引号包裹，避免YAML解析时将特殊字符（如$）误处理
3. 流水线类型混淆：MR触发的流水线属于merge_request_event类型，普通push规则不会匹配这类流水线，必须单独配置MR规则
4. 分支识别问题：若分支名称包含特殊字符，检查$CI_COMMIT_BRANCH是否能正确获取分支名（可在Job中添加echo $CI_COMMIT_BRANCH验证）

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