GitLab CI/CD 按指定条件触发流水线步骤配置不生效如何解决

核心问题原因 #

你当前配置的规则存在两个典型错误：

1. 合并请求（merge_request_event）场景下的分支判断逻辑错误：MR流水线中$CI_COMMIT_BRANCH是源分支名称，而非你要合并的目标分支名称，所以判断$CI_COMMIT_BRANCH == "develop"在MR场景下永远不成立
2. exists关键字对变量的支持存在版本或配置限制：如果GitLab版本过低、或者变量$MY_FILE未设置为「流水线创建时可用」，exists预解析阶段无法读取变量值，会判定文件不存在

排查步骤 #

1. 验证变量与触发条件实际值 #

添加临时调试步骤，确认各内置变量和自定义变量的实际取值：

debug_check:
  script:
    - echo "流水线来源：$CI_PIPELINE_SOURCE"
    - echo "当前提交分支：$CI_COMMIT_BRANCH"
    - echo "MR目标分支：$CI_MERGE_REQUEST_TARGET_BRANCH_NAME"
    - echo "自定义文件路径：$MY_FILE"
    - ls -la $MY_FILE
  rules:
    - if: '$CI_PIPELINE_SOURCE == "push" || $CI_PIPELINE_SOURCE == "web" || $CI_PIPELINE_SOURCE == "merge_request_event"'

运行流水线后查看该步骤输出，确认所有变量取值符合预期。

2. 确认GitLab版本与变量配置 #

• 若GitLab版本低于13.8，exists关键字不支持使用变量，只能写死文件路径
• 若版本≥13.8，进入项目「设置→CI/CD→变量」，确认$MY_FILE的「流水线创建时可用」选项已勾选

修正后的配置 #

标准写法（分场景判断，可读性更高） #

rules:
  # 场景1：直接推送代码到develop分支
  - if: '$CI_PIPELINE_SOURCE == "push" && $CI_COMMIT_BRANCH == "develop"'
    exists:
      - $MY_FILE
  # 场景2：GitLab UI手动触发，且选择分支为develop
  - if: '$CI_PIPELINE_SOURCE == "web" && $CI_COMMIT_BRANCH == "develop"'
    exists:
      - $MY_FILE
  # 场景3：合并请求目标分支为develop（含MR打开、更新时的流水线）
  - if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "develop"'
    exists:
      - $MY_FILE

如果需要覆盖MR合并完成后触发的推送流水线，上面的第一个场景已经自动覆盖，无需额外配置。

低版本GitLab兼容写法 #

如果版本不支持exists使用变量，把文件存在判断移到脚本层：

rules:
  - if: |
      ($CI_PIPELINE_SOURCE == "push" && $CI_COMMIT_BRANCH == "develop") ||
      ($CI_PIPELINE_SOURCE == "web" && $CI_COMMIT_BRANCH == "develop") ||
      ($CI_PIPELINE_SOURCE == "merge_request_event" && $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "develop")
script:
  # 先判断文件是否存在
  - if [ ! -f "$MY_FILE" ]; then echo "目标文件不存在，跳过执行" && exit 0; fi
  # 后续接原有步骤逻辑

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