GitLab Pipeline报错‘variables config should be a hash’求助排查

核心原因 #

报错variables config should be a hash的本质是GitLab CI解析器判定某个variables块的结构不符合要求，常见触发场景有两种：

• GitLab版本兼容性问题：GitLab 13.4及以上版本才支持在workflow.rules中通过variables覆盖全局变量。如果你的GitLab实例版本低于13.4，解析器会因为不识别该特性而报错结构错误。
• 数值字符串的解析异常：部分旧版本GitLab的YAML解析器对带下划线的数值字符串（如"1_000_000"）处理存在兼容性问题，会误判变量结构。

解决方案 #

方案1：升级GitLab版本

若条件允许，将GitLab实例升级至13.4或更高版本，即可正常使用workflow.rules中设置变量的特性。

方案2：改用Job级规则设置变量

放弃全局覆盖的方式，直接在需要使用变量的test Job中通过rules分支匹配设置变量：

test:
  stage: test
  allow_failure: false
  rules:
    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
      variables:
        max_depth: "6"
        max_nodes: "10_000_000"
    - if: $CI_COMMIT_REF_NAME == "dev"
      variables:
        max_depth: "5"
        max_nodes: "5_000_000"
    - when: always  # 其他分支沿用全局默认变量
  script:
    - pipenv run coverage run -m pytest --perft_depth=$max_depth --max_nodes=$max_nodes
    - pipenv run coverage report
    - pipenv run coverage xml
  coverage: '/TOTAL.*\s+(\d+%)$/'
  artifacts:
    expire_in: 30 days
    reports:
      coverage_report:
        coverage_format: cobertura
        path: coverage.xml

方案3：调整变量值格式

将带下划线的数值字符串改为纯数字格式，避免解析器误判：

variables:
  max_depth: "3"
  max_nodes: "1000000"

workflow:
  rules:
    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
      variables:
        max_depth: "6"
        max_nodes: "10000000"
    - if: $CI_COMMIT_REF_NAME == "dev"
      variables:
        max_depth: "5"
        max_nodes: "5000000"

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