Azure Pipeline模板传参遇循环引用：无法扩展变量TOKEN_QA的解决

问题根源 #

你遇到的cyclical reference警告，是因为定义中间变量（如token_qa）时使用了运行时变量语法（$()），随后又用编译时表达式（${{}}）引用这些中间变量，导致Pipeline解析时出现依赖循环。

解决方案 #

方案1：移除不必要的中间变量层（推荐） #

直接在模板参数中引用变量组的原始变量，省去中间赋值步骤，从根源避免循环引用：

修改主管道的variables和stages部分：

variables:
- group: api-mgmt-...-qa
- group: api-mgmt-...-dev
 
pool:
  name: '...'
  vmImage: ubuntu-latest

stages:
  - stage: "DEV_Deploy"
    dependsOn: []
    jobs:
      - template: ./api-publish_deployment.yml
        parameters:
          env: "dev"
          token: ${{variables.TOKEN_DEV}}
          project: ${{variables.PROJECT_ID_DEV}}

  - stage: "QA_Deploy"
    dependsOn: 
    - "DEV_Deploy"
    jobs:
      - template: ./api-publish_deployment.yml
        parameters:
          env: "qa"
          token: ${{variables.TOKEN_QA}}
          project: ${{variables.PROJECT_ID_QA}}

方案2：改用编译时语法定义中间变量 #

如果必须保留中间变量（比如需要统一变量名），将中间变量的赋值改为编译时表达式（${{}}），避免运行时语法和编译时语法混合导致的解析冲突：

修改主管道的variables部分：

variables:
- group: api-mgmt-...-qa
- name: token_qa
  value: ${{variables.TOKEN_QA}}  # 改用编译时语法
- name: project_qa
  value: ${{variables.PROJECT_ID_QA}}
- group: api-mgmt-...-dev
- name: token_dev
  value: ${{variables.TOKEN_DEV}}
- name: project_dev
  value: ${{variables.PROJECT_ID_DEV}}

额外检查点 #

• 确认两个变量组（api-mgmt-...-qa和api-mgmt-...-dev）内的变量无重名，避免变量覆盖导致的意外问题。
• 模板文件无需修改，保持现有参数接收逻辑即可。

内容的提问来源于stack exchange，提问作者Атанас Чолаков