Azure DevOps YAML流水线多阶段关联不同变量组时变量展开异常

该报错的核心原因是 Azure DevOps YAML 中 environment 字段属于编译阶段解析的属性，而你绑定在阶段内的变量组变量属于运行时变量，解析时机晚于 environment 字段的校验阶段，因此变量无法正常展开，系统会直接将$(environmentName)作为环境名称去匹配，自然找不到对应环境。

方案1：改用模板参数传值（最推荐） #

将环境名、变量组名等固定属性作为模板参数传递，编译阶段即可拿到明确值，完全规避变量解析顺序问题。调整方式如下：

1. 主流水线YAML调整为：

trigger:
- main

pool:
  vmImage: ubuntu-latest

stages:
  - template: deploy-stage.yml
    parameters:
      stageName: Dev
      environmentName: Dev
      variableGroupName: Config.Dev
  - template: deploy-stage.yml
    parameters:
      stageName: Prd
      environmentName: Prd
      variableGroupName: Config.Prd

2. 新增同名目录下的deploy-stage.yml模板文件：

parameters:
- name: stageName
  type: string
- name: environmentName
  type: string
- name: variableGroupName
  type: string

stages:
- stage: ${{ parameters.stageName }}
  variables:
  - group: ${{ parameters.variableGroupName }}
  jobs:
  - deployment:
    environment: ${{ parameters.environmentName }}
    strategy: 
      runOnce:
        deploy:
          steps:
          - checkout: self 
          - task: AzureCLI@2
            inputs:
              azureSubscription: $(azureSubscriptionName)
              scriptType: 'bash'
              scriptLocation: 'inlineScript'
              inlineScript: |
                az deployment sub create --location uksouth --template-file main.bicep

方案2：直接写死环境名 #

如果你的环境名和阶段名完全对应，无需动态配置，可以直接将environment: $(environmentName)改为固定值，Dev阶段写environment: Dev，Prd阶段写environment: Prd即可。

方案3：使用根级编译时变量映射 #

如果不想拆分模板，也可以在根级别定义环境映射关系，用编译时表达式读取对应值：

trigger:
- main

pool:
  vmImage: ubuntu-latest

variables:
- name: DevEnvName
  value: Dev
- name: PrdEnvName
  value: Prd

stages:
  - stage: Dev
    variables:
      - group: Config.Dev
    jobs:
      - deployment:
        environment: ${{ variables.DevEnvName }}
        strategy: 
          runOnce:
            deploy:
              steps:
              - checkout: self 
              - task: AzureCLI@2
                inputs:
                  azureSubscription: $(azureSubscriptionName)
                  scriptType: 'bash'
                  scriptLocation: 'inlineScript'
                  inlineScript: |
                    az deployment sub create --location uksouth --template-file main.bicep

  - stage: Prd
    variables:
      - group: Config.Prd
    jobs:
      - deployment:
        environment: ${{ variables.PrdEnvName }}
        strategy: 
          runOnce:
            deploy:
              steps:
              - checkout: self 
              - task: AzureCLI@2
                inputs:
                  azureSubscription: $(azureSubscriptionName)
                  scriptType: 'bash'
                  scriptLocation: 'inlineScript'
                  inlineScript: |
                    az deployment sub create --location uksouth --template-file main.bicep

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