Azure Pipelines YAML模板变量引用异常及PR分支分发需求

一、elseif判断不生效的原因 #

你遇到的elseif不生效问题，大概率是变量引用错误或条件匹配逻辑偏差导致的：

1. PR场景下分支变量混淆：在PR触发的构建中，Build.SourceBranch的值是类似refs/pull/123/merge的完整引用，而非单纯的merge；而PR的源分支需要用System.PullRequest.SourceBranch（值为refs/heads/my-branch-name）。如果你的判断条件直接匹配merge，自然无法命中。
2. 编译时/运行时变量误用：如果用了编译时表达式${{ }}，但PR相关变量（如System.PullRequest.SourceBranch）只有在运行时才会被赋值，编译时判断会因变量未初始化而失效，此时应改用运行时表达式$[ ]。
3. 字符串匹配精度问题：比如条件中未对分支值做精准匹配（没写全refs/heads/前缀），或者变量值存在隐形空格，导致判断不成立。

二、核心需求实现：特定PR源分支分发到特定分组 #

针对“特定PR源分支的构建分发到特定分组”的需求，直接用**条件表达式动态设置distributionGroupIds**即可，以下是可直接复用的YAML片段：

示例1：基于PR源分支的动态分发配置 #

steps:
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'Your-AppCenter-Endpoint'
    appSlug: 'your-org/your-app'
    # 用运行时条件表达式动态选择分发分组ID
    distributionGroupIds: >-
      $[
        eq(variables['System.PullRequest.SourceBranch'], 'refs/heads/my-branch-name') 
        ? '<guid2>' 
        : eq(variables['Build.SourceBranch'], 'refs/heads/main') 
          ? '<guid1>' 
          : '<guid3>'
      ]
    releaseNotesOption: 'input'
    releaseNotes: |
      [merge]
      [refs/heads/my-branch-name]

关键说明： #

• 变量选择：必须用System.PullRequest.SourceBranch来获取PR的源分支，而非Build.SourceBranch（后者是PR的合并分支）。
• 表达式语法：用$[ ]运行时表达式，确保PR变量已被正确赋值后再做判断；多条件嵌套用?:三元运算符实现类似elseif的逻辑。
• 分支匹配：要写全分支的完整引用路径（如refs/heads/my-branch-name），避免部分匹配导致的逻辑错误。

示例2：多分支场景的清晰写法（用模板变量拆分逻辑） #

如果需要匹配的分支较多，可先定义模板变量拆分逻辑，提升可读性：

variables:
  - name: targetDistributionGroup
    value: >-
      $[
        eq(variables['System.PullRequest.SourceBranch'], 'refs/heads/feature/test') 
        ? '<test-group-guid>' 
        : eq(variables['System.PullRequest.SourceBranch'], 'refs/heads/feature/prod') 
          ? '<prod-group-guid>' 
          : '<default-group-guid>'
      ]

steps:
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'Your-AppCenter-Endpoint'
    appSlug: 'your-org/your-app'
    distributionGroupIds: '$(targetDistributionGroup)'
    releaseNotesOption: 'input'
    releaseNotes: 'PR from $(System.PullRequest.SourceBranch)'

验证方法 #

1. 触发对应PR构建后，在流水线的“变量”面板查看System.PullRequest.SourceBranch的实际值，确认分支路径是否与判断条件一致。
2. 开启流水线的“详细日志”，查看分发任务的输入参数，确认distributionGroupIds是否被正确赋值。

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