Azure DevOps控制器管道传变量至子管道失败，是否需改用参数？

核心结论 #

方案可行，但你当前的变量传递方式有误，更推荐子管道改用参数接收外部输入，这是Azure DevOps跨管道传值的标准做法，能彻底解决变量为空的问题。

为什么直接传变量会失效 #

Azure DevOps中，子管道的运行环境是隔离的，控制器管道的变量不会自动继承到子管道。你单独运行子管道时能正常工作，是因为手动设置了子管道自身的变量；但控制器管道传递的变量没有被子管道正确接收，导致子管道使用默认空值报错。

正确实现方式：改用参数传递 #

1. 重构子管道，定义参数 #

在子管道的YAML中，用parameters块定义需要接收的输入，替代原有的变量定义：

# 子管道YAML
parameters:
  - name: envName
    type: string
    description: 环境名称
  - name: appVersion
    type: string
    description: 应用版本号
  # 按需添加其他3-5个参数

jobs:
  - job: SubPipelineJob
    steps:
      - script: echo "当前环境: ${{ parameters.envName }}"
      - script: echo "应用版本: ${{ parameters.appVersion }}"
      # 后续步骤直接使用${{ parameters.参数名 }}调用

2. 控制器管道调用子管道并传递参数 #

控制器管道中先引用子管道资源，再在调用时将自身变量映射到子管道的参数：

# 控制器管道YAML
variables:
  - name: controllerEnvName
    value: 'prod'
  - name: controllerAppVersion
    value: 'v1.0.0'
  # 定义控制器接收的3-5个变量

resources:
  pipelines:
    - pipeline: MySubPipeline
      source: '你的子管道名称'
      project: '所属项目名称'

jobs:
  - job: TriggerSubPipeline
    steps:
      - checkout: none
      - task: AzurePipeline@1
        inputs:
          azureSubscription: '你的Azure订阅连接'
          pipeline: 'MySubPipeline'
          parameters: |
            envName: '${{ variables.controllerEnvName }}'
            appVersion: '${{ variables.controllerAppVersion }}'
            # 映射其他变量到对应参数

可选：强行用变量传递的方式（不推荐） #

如果坚持用变量传递，需要在子管道中显式引用控制器管道传递的变量，但这种方式可读性差、易出错：

# 子管道YAML中添加变量引用
variables:
  - name: envName
    value: ${{ variables.envName }} # 依赖控制器传递的同名变量
  - name: appVersion
    value: ${{ variables.appVersion }}

调用时控制器管道需要在AzurePipeline@1任务中通过variables字段传递：

# 控制器管道调用任务
- task: AzurePipeline@1
  inputs:
    azureSubscription: '你的订阅'
    pipeline: 'MySubPipeline'
    variables: |
      envName: '${{ variables.controllerEnvName }}'
      appVersion: '${{ variables.controllerAppVersion }}'

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