如何避免Azure Pipeline“管道需含至少一个无依赖作业”错误？

问题原因 #

当所有作业都通过${{ if }}编译时条件过滤后，管道中没有任何作业定义，触发Azure Pipeline的必填校验：“管道必须包含至少一个无依赖作业”。

解决方案 #

方法1：添加永不执行的占位符作业 #

在作业列表最上方添加一个条件为false的空作业，确保管道始终有作业定义，同时该作业不会实际执行，也不会干扰构建结果。

jobs:
  # 占位符作业：永远不执行，仅满足管道作业数量要求
  - job: PlaceholderJob
    displayName: '占位符作业'
    condition: false
    steps:
      - script: echo "此作业不会执行"

  # 各环境作业：根据PR目标分支条件生成
  - ${{ if eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/dev') }}:
    - template: templates/dev-job.yml

  - ${{ if eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/test') }}:
    - template: templates/test-job.yml

  - ${{ if eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/staging') }}:
    - template: templates/staging-job.yml

  # 其他环境作业依次类推

方法2：动态选择目标模板（更简洁） #

通过变量动态指定要加载的作业模板，仅生成对应环境的作业，同时配置默认空模板处理意外分支场景。

1. 定义分支与模板的映射变量：

variables:
  - name: TargetJobTemplate
    # 根据PR目标分支匹配对应模板
    ${{ if eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/dev') }}:
      value: 'templates/dev-job.yml'
    ${{ elseif eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/test') }}:
      value: 'templates/test-job.yml'
    ${{ elseif eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/prod') }}:
      value: 'templates/prod-job.yml'
    # 其他分支映射...
    # 默认空模板，避免无作业报错
    ${{ else }}:
      value: 'templates/empty-job.yml'

jobs:
  # 仅加载匹配的模板作业
  - template: ${{ variables.TargetJobTemplate }}

2. 创建empty-job.yml空模板：

job: EmptyJob
displayName: '无匹配作业'
condition: false
steps:
  - script: echo "未找到与目标分支匹配的环境作业"

效果说明 #

• 两种方法都能避免“无作业”报错，且仅执行对应环境的作业。
• 永不执行的占位符/空作业不会出现在构建结果的已执行作业列表中，只会显示实际运行的环境作业。
• 编译时表达式${{ if }}确保管道初始化阶段就过滤掉不需要的作业，不会在构建结果页显示未执行的环境作业。

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