ADO中PR触发管道时无法在条件中使用System.PullRequest.targetBranchName变量

需求 #

• 发起拉取请求（PR）时自动触发Azure DevOps管道，管道执行成功后通过分支策略完成合并
• 环境参数默认值为NONPROD，管道自动触发时根据目标分支匹配对应环境：
  • 目标分支为develop时，环境设为NFT
  • 目标分支为main时，环境设为PROD

用户尝试的代码及问题 #

用户通过以下代码设置变量，输出中能正确显示目标分支，但条件判断未生效，始终输出默认值NONPROD：

variables:
  - name: mode
    value: 'apply'
  - name: environment
    ${{ if eq( variables['System.PullRequest.targetBranchName'], 'main' ) }} : 
      value: 'PROD'
    ${{ if eq( variables['System.PullRequest.targetBranchName'], 'develop' ) }} : 
      value: 'NFT'
    ${{ else }}:
      value: 'NONPROD'

用于检查变量的阶段代码：

stages:
  - stage: setprerequisites
    displayName: "setprerequisites"
    jobs:
      - job: checkvariables
        displayName: "check variables"
        steps:
          - script: |
                   echo "source working directory               --> $(System.DefaultWorkingDirectory)"
                   echo "selected default environmentparameter  --> ${{ parameters.environment }}"
                   echo "selected environment from variables    --> $(environment)"
                   echo "target branch                          --> $(System.PullRequest.targetBranchName)"
                   echo "selected terraform mode to apply       --> ${{ parameters.mode }}"
                   echo "terraform ${{ parameters.mode }} will be applied on $(environment) environment"

输出结果：

• selected environment from variables --> NONPROD
• target branch --> develop
• selected terraform mode to apply --> apply

原因分析 #

${{ ... }}属于编译时表达式，会在管道开始运行前完成解析；而System.PullRequest.targetBranchName是运行时变量，只有管道启动后才能获取到真实值。编译时该变量尚未被填充，所有if条件均不满足，最终触发else分支设置默认值NONPROD。

解决方案 #

方法1：通过运行时命令动态设置变量 #

在步骤中利用Azure DevOps的任务命令，根据目标分支值实时设置环境变量：

stages:
  - stage: setprerequisites
    displayName: "setprerequisites"
    jobs:
      - job: checkvariables
        displayName: "check variables"
        steps:
          - script: |
              # 根据目标分支设置环境变量
              if [ "$(System.PullRequest.targetBranchName)" = "main" ]; then
                echo "##vso[task.setvariable variable=environment;isOutput=true]PROD"
              elif [ "$(System.PullRequest.targetBranchName)" = "develop" ]; then
                echo "##vso[task.setvariable variable=environment;isOutput=true]NFT"
              else
                echo "##vso[task.setvariable variable=environment;isOutput=true]NONPROD"
              fi
            name: set_env_var
          - script: |
              echo "source working directory               --> $(System.DefaultWorkingDirectory)"
              echo "selected default environmentparameter  --> ${{ parameters.environment }}"
              echo "selected environment from variables    --> $(set_env_var.environment)"
              echo "target branch                          --> $(System.PullRequest.targetBranchName)"
              echo "selected terraform mode to apply       --> ${{ parameters.mode }}"
              echo "terraform ${{ parameters.mode }} will be applied on $(set_env_var.environment) environment"

通过##vso[task.setvariable]命令设置输出变量，后续步骤通过$(set_env_var.environment)引用最终生效的环境值。

方法2：结合分支触发器的变量组（可选） #

如果目标分支固定为main和develop，可在管道的分支触发器中关联对应变量组：

1. 在Azure DevOps中创建两个变量组：PROD-Env（含environment: PROD）、NFT-Env（含environment: NFT）
2. 在管道触发器配置中：
   • 当PR目标分支为main时，关联PROD-Env变量组
   • 当PR目标分支为develop时，关联NFT-Env变量组
3. 默认情况下使用NONPROD作为环境值

这种方式适合分支与环境映射固定且无需动态判断的场景。

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