Azure DevOps Pipeline：stageDependencies与dependencies区别及变量引用问题

一、stageDependencies与dependencies的核心区别 #

• stageDependencies：用于跨阶段引用输出变量，格式为 $[ stageDependencies.<阶段名>.<作业名>.outputs['<任务名>.<变量名>'] ]，仅能在当前阶段的作业中引用其他阶段的作业输出。
• dependencies：用于同阶段内跨作业引用输出变量，格式为 $[ dependencies.<作业名>.outputs['<任务名>.<变量名>'] ]，仅能引用当前阶段里前置作业的输出。

二、你的问题排查与修复方案 #

问题核心原因 #

1. 模板脚本语法错误：get-sa-token.yml中$IdentToken .access.token.id的$IdentToken后多了一个空格，导致$token变量赋值为空，最终输出的SaToken自然是空值。
2. 阶段配置语法错误：DeployAzure阶段的dependsOn与condition写在同一行，不符合YAML语法，可能导致依赖解析异常。
3. Secret变量显示特性：即使变量赋值正常，直接用Write-Host输出Secret类型变量会被Azure DevOps自动屏蔽，看起来像是空值，但变量实际已传递。

修复步骤 #

1. 修正模板中的变量赋值错误

修改get-sa-token.yml中的$token赋值语句，移除多余空格：

# 原错误代码
$token = $IdentToken .access.token.id
# 修正后代码
$token = $IdentToken.access.token.id

2. 修正DeployAzure阶段的语法错误

将dependsOn与condition拆分到不同行：

# 原错误代码
- stage: DeployAzure
  dependsOn:
  - DetermineEnvironment  condition: eq(variables['CloudProvider'], 'Azure')
# 修正后代码
- stage: DeployAzure
  dependsOn: DetermineEnvironment
  condition: eq(variables['CloudProvider'], 'Azure')

3. 正确验证Secret变量

在OutputToken作业的PowerShell脚本中，不要直接输出Secret明文，改用存在性验证：

script: |
  if ($env:SaToken) {
    Write-Host "SaToken 已成功传递（Secret值已被屏蔽）"
  } else {
    Write-Host "SaToken 为空，请检查上游作业"
  }

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