Azure DevOps阶段输出未正确解析：Angular构建版本变量异常

问题描述 #

我在为Angular/.NET项目构建通用管道模板时遇到异常：管道分为Prework、Angular、Backend三个阶段，Prework阶段通过GitVersion获取版本号并输出变量，但其中一个仓库的Angular阶段执行ng build时，版本变量未被正确解析，报错：

npm ERR! Invalid version: "$[stageDependencies.Prework.General.outputs[CreateVersions.GitVersion.SemVer]]"

所有版本号均显示为未解析的原始表达式，其他仓库使用相同模板可正常运行，已检查浅克隆设置、语法、管道配置，未定位到原因。

排查与解决方案 #

1. 修正跨阶段变量引用语法 #

跨阶段引用变量的标准格式为$[stageDependencies.<阶段名>.<作业名>.outputs['<任务名>.<变量名>']]，需注意：

• 确认Prework阶段中的作业名称确实为General，若作业名不匹配，变量将无法解析
• 优先使用你通过PowerShell任务输出的Versions.version变量，而非GitVersion任务的原生输出，因为自定义输出变量的跨阶段访问更稳定，正确引用路径为：

  $[stageDependencies.Prework.General.outputs['Versions.version']]
  

2. 明确阶段依赖与变量定义 #

确保Angular阶段的作业明确依赖Prework阶段，并正确定义变量：

stages:
  - stage: Angular
    dependsOn: Prework
    jobs:
      - job: BuildAngular
        variables:
          buildVersion: $[stageDependencies.Prework.General.outputs['Versions.version']]
        steps:
          - script: ng build --configuration production --version $(buildVersion)
            displayName: Build Angular App

注意变量引用时用单引号包裹键名，避免特殊字符解析异常。

3. 验证GitVersion输出有效性 #

在Prework阶段的PowerShell任务中增加日志，确认GitVersion.SemVer是否生成有效值：

Write-host "GitVersion.SemVer raw value: $(GitVersion.SemVer)"
Write-host "Version to build: $(GitVersion.SemVer)"
Write-Host "##vso[task.setvariable variable=version;isOutput=true]$(GitVersion.SemVer)"

同时检查该仓库的.gitversion配置文件是否正确，以及Git提交历史是否符合GitVersion的版本计算规则（如是否存在有效标签、提交信息是否符合约定），异常的Git状态可能导致GitVersion无法生成有效版本号。

4. 确认模板参数传递正确性 #

检查该仓库使用的主模板是否正确传递了gitVersionFilePath参数，确保指向的.gitversion文件路径存在且有效，路径错误会导致GitVersion使用默认配置，进而引发版本生成异常。

5. 验证变量读取权限 #

在Angular阶段的第一步添加变量打印脚本，确认变量是否能被正常读取：

- script: echo "Resolved build version: $(buildVersion)"
  displayName: Check Build Version Variable

若输出仍为原始表达式，需检查管道是否启用了特殊资源隔离配置（如专用代理池的权限限制），导致跨阶段变量无法传递。

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