Azure DevOps YAML基于分支名动态赋值变量失败问题排查

问题根源：表达式执行时机不匹配 #

你遇到的变量赋值失效问题，核心原因是编译时表达式（${{ ... }}）和运行时表达式（$[ ... ]）的执行顺序差异：

• BRANCH_NAME 用 $[replace(...)]) 定义，属于运行时表达式，会在流水线运行阶段才计算出实际值。
• ${{ if eq(variables['BRANCH_NAME'], 'dev') }} 属于编译时条件判断，会在流水线开始运行前就执行。此时BRANCH_NAME还未被计算，仍是原始表达式字符串，所有条件判断都不成立，导致AZURE_SUBSCRIPTION等变量从未被赋值。

另外，Build.SourceBranchName无法处理带/的分支，因为它仅返回分支路径的最后一段（比如feature/xxx会被截断为xxx），无法匹配完整分支名。

解决方案：统一用编译时表达式处理分支名 #

直接在编译时条件中处理Build.SourceBranch，跳过中间变量BRANCH_NAME，确保条件判断在编译阶段就能拿到完整分支名：

variables:
  # 直接在编译时替换分支路径前缀，匹配完整分支名
  ${{ if eq(replace(variables['Build.SourceBranch'], 'refs/heads/', ''), 'dev') }}:
    TF_ENVIRONMENT: dev
    AZURE_SUBSCRIPTION: xxxx
    AZURE_SUBSCRIPTION_ID: xxx
  ${{ elseif eq(replace(variables['Build.SourceBranch'], 'refs/heads/', ''), 'staging') }}:
    TF_ENVIRONMENT: stage
    AZURE_SUBSCRIPTION: 'test'
    AZURE_SUBSCRIPTION_ID: xxxx
  ${{ elseif eq(replace(variables['Build.SourceBranch'], 'refs/heads/', ''), 'feature/xxx') }}:
    TF_ENVIRONMENT: xxx
    AZURE_SUBSCRIPTION: xxxx
    AZURE_SUBSCRIPTION_ID: xxxx
  ${{ elseif eq(replace(variables['Build.SourceBranch'], 'refs/heads/', ''), 'master') }}:
    TF_ENVIRONMENT: prod
    AZURE_SUBSCRIPTION: xxxxx
    AZURE_SUBSCRIPTION_ID: xxxxx

steps:
  - script: |
      echo "当前分支: $(Build.SourceBranch)"
      echo "TF_ENVIRONMENT: $(TF_ENVIRONMENT)"
      echo "AZURE_SUBSCRIPTION: $(AZURE_SUBSCRIPTION)"
    displayName: '验证变量赋值'
  - task: AzureCLI@2
    inputs:
      azureSubscription: $(AZURE_SUBSCRIPTION)
      # 其他任务配置...

补充说明 #

• 编译时表达式能直接访问Build.SourceBranch变量，替换refs/heads/前缀后可完整匹配带/的分支路径。
• AzureCLI任务的azureSubscription参数依赖编译时解析服务连接，因此必须用编译时条件赋值，确保任务执行前变量已确定。

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