GitLab CI规则异常：主分支流水线始终被阻止的排查与修复

你的规则逻辑存在两个核心问题：

• 第一条规则的if: $CI_COMMIT_REF_NAME条件永远成立（分支/标签名必然存在），只要提交中包含.md文件或docs目录下的内容，无论是否同时有代码、Dockerfile等其他变更，都会触发when: never直接阻止流水线。这完全违背了你“仅当仅文档变更时才不触发”的需求。
• 第二条规则因为第一条规则的优先级更高，永远不会被执行，导致主分支的流水线只要涉及文档变更就会被拦截，完全不符合预期。

调整规则逻辑，精准判断“仅文档变更”的场景，其他所有情况（包括主分支有非文档变更、分支同时包含文档和代码变更）都触发流水线：

.never_for_md_or_docs: &never_for_md_or_docs
  rules:
    # 场景1：存在非文档文件变更 → 触发流水线
    - if: $CI_COMMIT_REF_NAME
      changes:
        - "**/*"
      except:
        - "**/*.md"
        - "**/docs/**/*"
      when: always
    # 场景2：仅文档文件变更 → 不触发流水线
    - if: $CI_COMMIT_REF_NAME
      changes:
        - "**/*.md"
        - "**/docs/**/*"
      when: never
    # 场景3：无变更（CI通常不会触发此类流水线）→ 不触发
    - when: never

规则说明 #

1. 第一条规则：检查是否存在非文档文件的变更（即代码、Dockerfile等不属于文档范畴的文件），如果存在则直接触发流水线，覆盖“文档+代码同时变更”的场景。
2. 第二条规则：仅当所有变更都属于文档文件时，才阻止流水线，精准匹配你需要的拦截场景。
3. 最后一条规则处理极端无变更的情况，避免不必要的流水线触发。

如果你希望主分支即使仅文档变更也触发流水线，可以在第二条规则前添加主分支的判断：

.never_for_md_or_docs: &never_for_md_or_docs
  rules:
    # 主分支无论何种变更都触发流水线
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
      when: always
    # 非主分支：存在非文档变更触发，仅文档变更不触发
    - if: $CI_COMMIT_REF_NAME
      changes:
        - "**/*"
      except:
        - "**/*.md"
        - "**/docs/**/*"
      when: always
    - if: $CI_COMMIT_REF_NAME
      changes:
        - "**/*.md"
        - "**/docs/**/*"
      when: never
    - when: never

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