Azure DevOps YAML流水线跨阶段访问变量失败求助

1. 确认步骤模板中任务的名称（关键） #

在set-version.yml的PowerShell任务中，必须显式指定唯一的name属性——跨阶段引用输出变量时，需要通过「任务名.变量名」的格式定位变量。如果任务未设置name，Azure DevOps会使用默认名称（如PowerShell），直接导致引用路径失效。

示例修正（set-version.yml）：

steps:
- task: PowerShell@2
  name: SolutionVersion  # 必须与引用表达式中的`SolutionVersion`完全匹配
  inputs:
    targetType: 'inline'
    script: |
      $newVersion = "1.0.0.1"
      Write-Host "##vso[task.setvariable variable=NewVersion;isOutput=true]$newVersion"

2. 检查Deployment作业的配置 #

Deployment类型作业必须指定environment，同时确保作业的name属性与引用中的ExportSolutionJob一致。

示例（export-solution-job.yml）：

jobs:
- deployment: ExportSolutionJob
  displayName: Export Solution Job
  environment: 'YourEnvironmentName'  # Deployment作业必填环境配置
  strategy:
    runOnce:
      deploy:
        steps:
        - template: set-version.yml

3. 确认阶段依赖的正确配置 #

第二阶段必须显式声明依赖第一阶段，否则无法读取前一阶段的输出变量。

示例（主流水线YAML）：

stages:
- stage: ExportSolutionStage
  displayName: Export Solution Stage
  jobs:
  - template: export-solution-job.yml

- stage: build_stage
  displayName: Build Stage
  dependsOn: ExportSolutionStage  # 必须添加该依赖声明
  variables:
    RetrievedVersion: $[stageDependencies.ExportSolutionStage.ExportSolutionJob.outputs['SolutionVersion.NewVersion']]
  jobs:
  - job: BuildJob
    steps:
    - script: echo "Retrieved version is $(RetrievedVersion)"

4. 检查变量设置的语法细节 #

确保##vso命令格式完全正确：

• 变量名与isOutput=true之间用分号分隔，无多余空格
• 变量值直接紧跟命令，无空格
• 注意大小写：Azure DevOps的任务名、变量名均为大小写敏感，引用时需与定义完全一致

错误示例：

# 错误：isOutput=true前存在空格
Write-Host "##vso[task.setvariable variable=NewVersion; isOutput=true]$newVersion"

正确示例：

Write-Host "##vso[task.setvariable variable=NewVersion;isOutput=true]$newVersion"

5. 验证引用路径的层级 #

引用表达式必须严格遵循以下结构：
$[stageDependencies.阶段名.作业名.outputs['任务名.变量名']]

• 阶段名：ExportSolutionStage（需与第一阶段名称完全匹配）
• 作业名：ExportSolutionJob（需与Deployment作业名称完全匹配）
• 任务名：SolutionVersion（需与步骤模板中PowerShell任务的name完全匹配）
• 变量名：NewVersion（需与##vso命令中定义的变量名完全匹配）

任何层级名称的拼写错误，都会导致变量解析为Null。

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