GitLab CI规则中分支名称匹配不生效问题排查

核心问题原因 #

GitLab CI的rules条件解析时机和script脚本执行时机存在本质差异：

• rules中的if条件在流水线初始化阶段解析，这个阶段job内自定义变量的引用不会被递归展开。当你设置COMPARE_BRANCH: $CI_COMMIT_BRANCH时，rules里的$COMPARE_BRANCH会被当作字面量字符串"$CI_COMMIT_BRANCH"，而非实际分支名，导致$CI_COMMIT_BRANCH == $COMPARE_BRANCH的条件永远不成立。
• script中的if判断在作业运行阶段由shell执行，此时所有变量会被shell正常解析替换，所以$COMPARE_BRANCH能被替换为实际分支名，判断自然生效。

解决方案 #

方案1：直接在rules中写死分支判断逻辑 #

如果仅需针对main分支设置POST为True，无需变量中转，直接修改rules：

rules:
  - if: $CI_COMMIT_BRANCH == "main"
    variables:
      POST: True
  - when: on_success

方案2：将COMPARE_BRANCH设为项目级变量 #

若需要通过变量管理目标分支，在GitLab项目设置→CI/CD→变量中添加COMPARE_BRANCH并赋值为main。项目级变量会在流水线初始化阶段被加载，rules条件能正常解析匹配。

方案3：用YAML锚点复用判断逻辑 #

如果需要在多个job中复用分支判断逻辑，可使用YAML锚点：

.compare_branch_rule: &compare_branch_rule
  if: $CI_COMMIT_BRANCH == "main"

test-job:
  variables:
    POST: False
    COMPARE_BRANCH: main
  script:
    - echo "CI_COMMIT_BRANCH:$CI_COMMIT_BRANCH"
    - echo "COMPARE_BRANCH:$COMPARE_BRANCH"
    - if [[ $CI_COMMIT_BRANCH == $COMPARE_BRANCH ]]; then
    - echo "CI_COMMIT_BRANCH == COMPARE_BRANCH"
    - echo "$CI_COMMIT_BRANCH == $COMPARE_BRANCH"
    - else
    - echo "CI_COMMIT_BRANCH != COMPARE_BRANCH"
    - echo "$CI_COMMIT_BRANCH != $COMPARE_BRANCH"
    - fi
    - echo "POST:$POST"
  rules:
    - <<: *compare_branch_rule
      variables:
        POST: True
    - when: on_success

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