GitLab CI使用!reference复用rules报无效YAML错误求助

核心语法修正 #

你的配置中存在嵌套数组的语法错误，这是GitLab判定YAML无效的根本原因。当前写法会将.rules_push_only的整个rules数组作为build-code规则数组的单个元素，形成嵌套结构，不符合GitLab的规则解析要求。

修正后的正确配置：

stages:
  - build

.rules_push_only:
    rules:
    - if: $CI_PIPELINE_SOURCE == "push"

build-code:
  stage: build
  script:
    - echo "$CI_JOB_NAME complete."
  rules: !reference [.rules_push_only, rules]

错误原因解释 #

!reference [.rules_push_only, rules]会直接返回目标模板中的rules数组，因此不需要在前面添加短横线-。添加短横线后，rules字段会变成[ [ {if: "..."} ] ]的嵌套数组结构，GitLab的YAML解析器无法识别这种格式，从而抛出无效错误。

流水线编辑器与网页端的矛盾说明 #

流水线编辑器的语法检查仅做基础的YAML格式校验，不会严格验证GitLab CI特定的规则结构逻辑；而实际运行时的解析器会严格校验规则的层级和格式，因此会出现提示不一致的情况。

扩展：复用规则并追加自定义规则 #

如果你需要在复用基础规则的同时添加额外规则，可采用以下写法（GitLab 15.4+支持）：

build-code:
  stage: build
  script:
    - echo "$CI_JOB_NAME complete."
  rules:
    - !reference [.rules_push_only, rules]
    - if: $CI_COMMIT_BRANCH == "main"
      when: manual

此写法会自动展开复用的规则数组，与自定义规则合并为一个扁平数组，满足多规则组合的需求。

其他排查要点 #

• 缩进校验：确保所有缩进使用空格（禁止用Tab键），YAML对缩进的一致性要求极高。
• 缓存刷新：GitLab云版本可能存在配置缓存，可通过提交一个微小修改（如添加空行）触发重新解析。
• 本地校验：使用yamllint等工具本地校验YAML语法，提前排查格式错误。

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