Azure YAML Pipeline中cancelTimeoutInMinutes不生效问题咨询

现象描述 #

• 手动触发流水线后，1分钟内通过UI发起取消操作，流水线却持续运行，cancelTimeoutInMinutes: 1配置完全没起作用
• 移除Stage上的条件eq(variables['Build.SourceBranch'], 'refs/heads/main')后，流水线能正常响应取消；保留该条件则取消无效

核心原因 #

Azure DevOps里，当Stage绑定了动态运行时条件（比如基于Build.SourceBranch的分支判断）时，流水线的取消信号传递逻辑会被干扰。因为Stage的条件判断是在流水线初始化阶段执行的，而作业的取消钩子需要在作业启动前正常注册——Stage级别的条件会打乱这个注册流程，导致cancelTimeoutInMinutes无法触发强制终止。

解决方案 #

方案1：将条件下移到Job级别

把分支判断从Stage移到Job上，这样作业的取消逻辑可以正常初始化，条件仅控制Job是否执行，不影响取消信号的传递：

trigger:
- none

pool:
  vmImage: windows-latest

stages:
- stage:
    jobs:
    - job:
        condition: eq(variables['Build.SourceBranch'], 'refs/heads/main')
        cancelTimeoutInMinutes: 1
        steps:
        - task: PowerShell@2
          inputs:
            targetType: 'inline'
            script: |
              for ($i=0; $i -le 200; $i++){
                $i
                start-sleep -s 2
              }

方案2：改用预处理变量控制Stage执行

如果必须在Stage级别控制，可提前定义条件变量，避免直接在Stage的condition中使用动态分支变量：

trigger:
- none

variables:
  - name: RunMainStage
    value: $[eq(variables['Build.SourceBranch'], 'refs/heads/main')]

pool:
  vmImage: windows-latest

stages:
- stage:
    condition: eq(variables.RunMainStage, 'True')
    jobs:
    - job:
        cancelTimeoutInMinutes: 1
        steps:
        - task: PowerShell@2
          inputs:
            targetType: 'inline'
            script: |
              for ($i=0; $i -le 200; $i++){
                $i
                start-sleep -s 2
              }

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