为何GitLab CI全局变量优先级高于项目变量？

已在项目级别定义了REGION变量，但GitLab CI流水线运行时，VENOM_VAR_region最终使用的是.gitlab-ci.yml中定义的REGION: ""null""值，而非项目变量。以下是排查分析和解决办法：

配置文件 #

.gitlab-ci.yml #

variables:
  REGION: '"null"' # 最终使用的是这个值

include:
  - local: header.yml

stages:
  - validate

Create Test:
  stage: validate
  variables:
    SUBDOMAIN: e2e-sn-$CI_PIPELINE_ID
  trigger:
    include: integration_test.yml
    strategy: depend
    forward:
      pipeline_variables: true
  rules:
    - if: $RUN_E2E_INTEGRATION_TESTS == "true"
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      variables:
        RESTART_TEST: 'true'
      when: manual
      changes:
        - 'venom/e2e/**/*'

header.yml #

.e2e:
  rules:
    - if: $CI_PIPELINE_SOURCE == "parent_pipeline"

.venomE2E:
  variables: 
    VENOM_VAR_region: $REGION
    VENOM_VAR_subdomain: $SUBDOMAIN
  extends:
    - .e2e

integration_test.yml #

include:
  - local: header.yml

stages:
  - Create

Create site:
  stage: Create
  extends: .venomE2E
  script:
    - venom run e2e/create.yaml

原因分析 #

GitLab CI的变量优先级规则是：流水线配置文件（.gitlab-ci.yml）中显式定义的变量 > 项目级变量 > 组级/全局变量。你在.gitlab-ci.yml的variables块里直接赋值了REGION，这个定义会覆盖项目级别设置的REGION变量，导致流水线最终使用的是配置文件里的值。

另外，触发子流水线时启用了forward: pipeline_variables: true，父流水线里的REGION已经被配置文件的定义覆盖，所以子流水线拿到的也是这个被覆盖后的值，最终VENOM_VAR_region使用的就是配置文件里的"null"。

解决办法 #

方案1：移除配置文件中的REGION定义 #

直接删除.gitlab-ci.yml里variables块中的REGION行，这样项目级别定义的REGION变量就会自动生效：

variables:
  # 移除REGION: '"null"'这一行

方案2：保留默认值，允许项目变量覆盖 #

如果需要在没有项目变量时使用默认值"null"，可以用变量扩展语法定义REGION，这样项目变量存在时会自动覆盖默认值：

variables:
  REGION: ${REGION:-"null"} # 项目变量存在则用项目值，否则用"null"

修改后，父流水线会优先使用项目级的REGION变量，子流水线通过变量传递也能拿到正确的值，VENOM_VAR_region就会使用你在项目中定义的REGION值了。

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