Gitlab CI配置报错：rules与except不可混用，原因及解决方法

问题场景 #

我在GitLab CI流水线中定义了一个仅希望在master分支运行的任务：

docker:build-production:
  extends:
    - .docker:build
    - .aws-production-variables
  rules:
    - if: $CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH
      when: never

执行流水线时收到报错：

jobs:docker:build-production config key may not be used with `rules`: except

排查后发现，报错原因是该任务继承的.docker:build模板中包含except子句——GitLab CI要求同一个任务必须统一使用rules或only/except语法，不能混用。

解决方案 #

有两种可行的解决方式，根据实际场景选择：

方式一：统一使用rules语法（推荐） #

修改.docker:build模板，将其中的except替换为rules语法，保持整个流水线的语法一致性：
假设原模板内容为：

.docker:build:
  script: docker build -t my-image .
  except:
    - tags

修改为：

.docker:build:
  script: docker build -t my-image .
  rules:
    - if: $CI_COMMIT_TAG
      when: never

之后原任务的rules配置可以正常保留，实现仅在默认分支运行的需求。

方式二：切换回only/except语法 #

如果不想修改模板，可将当前任务的rules替换为only/except语法，实现仅在master分支运行的逻辑：

docker:build-production:
  extends:
    - .docker:build
    - .aws-production-variables
  only:
    - $CI_DEFAULT_BRANCH  # 用变量适配不同项目的默认分支，比写死master更通用

或者直接指定分支：

docker:build-production:
  extends:
    - .docker:build
    - .aws-production-variables
  only:
    - master

核心原因 #

GitLab CI的任务配置中，rules和only/except是两套互斥的分支/触发控制语法，同一个任务（包括继承的模板内容）不能同时使用这两套语法，必须保持统一。

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