Azure Pipelines条件判断语句未正确执行问题排查

问题定位 #

你遇到的PR触发时步骤不执行的核心问题，大概率是**System.PullRequest.TargetBranch变量的格式匹配错误**。这个变量的实际值是带完整refs路径的（比如refs/heads/develop），而非直接的分支名develop，如果你的条件里直接写等于develop，会导致匹配失败。

正确的条件表达式 #

以下是符合你三个场景的完整条件，已经适配了变量格式：

condition: |
  (
    eq(variables['Build.Reason'], 'PullRequest') and
    (
      eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/develop') or
      eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/master')
    )
  ) or
  (
    eq(variables['Build.Reason'], 'IndividualCI') and
    eq(variables['Build.SourceBranch'], 'refs/heads/develop')
  ) or
  (
    eq(variables['Build.Reason'], 'Manual') and
    not(
      eq(variables['Build.SourceBranch'], 'refs/heads/develop') or
      eq(variables['Build.SourceBranch'], 'refs/heads/master')
    )
  )

关键细节说明 #

• PR场景：必须用完整的refs/heads/分支名来匹配System.PullRequest.TargetBranch，这是Azure Pipelines的默认变量格式
• IndividualCI场景：Build.SourceBranch同样需要用完整refs路径匹配
• Manual场景：通过not()排除develop和master分支，确保特性分支能触发

完整步骤示例 #

把条件应用到具体步骤的yaml示例：

steps:
- script: echo "执行测试构建步骤"
  displayName: "运行测试"
  condition: |
    (
      eq(variables['Build.Reason'], 'PullRequest') and
      (
        eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/develop') or
        eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/master')
      )
    ) or
    (
      eq(variables['Build.Reason'], 'IndividualCI') and
      eq(variables['Build.SourceBranch'], 'refs/heads/develop')
    ) or
    (
      eq(variables['Build.Reason'], 'Manual') and
      not(
        eq(variables['Build.SourceBranch'], 'refs/heads/develop') or
        eq(variables['Build.SourceBranch'], 'refs/heads/master')
      )
    )

验证方法 #

可以在PR触发的构建日志里，查看System.PullRequest.TargetBranch的实际值，确认和条件里的格式一致；也可以在步骤前加一个打印变量的脚本，辅助排查：

- script: |
    echo "Build.Reason: $(Build.Reason)"
    echo "System.PullRequest.TargetBranch: $(System.PullRequest.TargetBranch)"
    echo "Build.SourceBranch: $(Build.SourceBranch)"
  displayName: "打印构建变量"

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