Azure DevOps 跨阶段运行时变量传递给模板后无法解析如何解决？

AI 小北

2026-10-2

问题根因

该报错是Azure DevOps编译时变量与运行时变量的解析逻辑差异导致的：

${{ }}是编译时语法，会在流水线启动时就完成参数替换，无法解析运行时才生成的输出变量
你传入模板的$[stageDependencies.determine_merge_base.xxx]是运行时表达式，直接通过编译时语法展开到脚本中后，bash会将$[]识别为算术扩展语法，尝试解析其中的内容，自然触发语法报错。

解决方案

步骤1：确认输出变量配置正确

首先检查../job_templates/determine_merge_base.yml中的输出变量配置是否符合要求，必须给设置变量的步骤指定名称，且添加isOutput=true标记：

# determine_merge_base.yml 核心配置示例
jobs:
- job: DetermineMergeBase
  steps:
  - bash: |
      # 计算合并基点的逻辑
      merge_base_val=$(git merge-base origin/main ${{ parameters.ref }})
      # 输出变量标记为可跨阶段传递
      echo "##vso[task.setvariable variable=merge_base;isOutput=true]$merge_base_val"
    name: git_merge_base # 必须和输出变量引用中的步骤名一致

步骤2：调整跨阶段变量传递方式

在build_master阶段先将跨阶段输出变量声明为阶段内运行时变量，再传递给模板，避免直接将$[]表达式传入脚本：

- stage: build_master
  dependsOn: determine_merge_base
  # 提前将跨阶段输出转为阶段内普通运行时变量
  variables:
    master_build_ref: $[stageDependencies.determine_merge_base.DetermineMergeBase.outputs['git_merge_base.merge_base']]
  jobs:
  - template: ../job_templates/check_if_binary_release_exists.yml
    parameters:
        ref: $(master_build_ref)
  - template: ../job_templates/build_and_upload_binaries.yml
    parameters:
        ref: $(master_build_ref)