Azure DevOps自定义任务能否捕获用户取消请求并优雅退出？

在Azure DevOps流水线中，自定义任务能否在执行期间检测到用户手动点击取消按钮的操作，并实现优雅退出？本文将分别介绍Node.js和PowerShell两种技术栈的实现方案，仅讨论用户手动触发的取消场景，不包含任务的条件执行终止情况。

取消操作的底层机制验证 #

此前有观点认为无法实现这类检测，但实际测试表明，用户取消作业时，系统并非直接强制终止进程，而是模拟Ctrl+C信号触发退出：

• 运行包含Start-Sleep的PowerShell任务或sleep 30s的命令行任务，取消时作业会立即退出而非等待执行完成
• 通过调试器连接sleep.exe并触发取消后，Visual Studio抛出异常：

Exception thrown at 0x00007FF832C3EA6B (KernelBase.dll) in sleep.exe: 0x40010005: Control-C.

该异常对应SEH错误码CONTROL_C_EXIT，说明取消操作本质是发送Ctrl+C信号，因此可通过捕获该信号实现优雅退出。

Node.js实现方案 #

Azure Pipelines Task Lib的Node文档未提供专门的取消检测API，但可通过原生Node.js的信号监听机制捕获Ctrl+C事件，进而执行优雅退出逻辑：

// 监听SIGINT信号（对应Ctrl+C，Windows/Linux均支持）
process.on('SIGINT', () => {
  console.log('检测到用户取消操作，开始执行优雅退出逻辑...');
  
  // 自定义清理操作：关闭数据库连接、保存临时状态、上报日志等
  cleanUpResources();
  
  // 返回非0状态码告知流水线任务被取消
  process.exit(1);
});

// 模拟任务执行逻辑
function runTask() {
  console.log('任务正在执行...');
  setInterval(() => console.log('任务运行中'), 1000);
}

// 示例清理函数
function cleanUpResources() {
  console.log('清理临时文件、释放占用资源...');
}

runTask();

PowerShell实现方案 #

PowerShell中可通过两种方式捕获Ctrl+C信号，实现优雅退出：

方式1：将Ctrl+C视为输入检测 #

# 配置控制台将Ctrl+C视为输入，而非直接终止进程
[Console]::TreatControlCAsInput = $true

Write-Host "任务正在执行...触发用户取消时将执行优雅退出"

while ($true) {
    Write-Host "任务运行中..."
    Start-Sleep -Seconds 1

    # 检查是否有Ctrl+C输入
    if ([Console]::KeyAvailable) {
        $keyInfo = [Console]::ReadKey($true)
        if ($keyInfo.Key -eq 'C' -and $keyInfo.Modifiers -eq 'Control') {
            Write-Host "`n检测到用户取消操作，开始执行清理..."
            
            # 自定义清理逻辑：删除临时文件、释放资源等
            Write-Host "完成资源清理，退出任务"
            
            exit 1
        }
    }
}

方式2：注册CancelKeyPress事件监听 #

# 注册控制台CancelKeyPress事件，捕获Ctrl+C信号
$eventHandler = Register-ObjectEvent -InputObject ([Console]::CancelKeyPress) -EventName 'CancelKeyPress' -Action {
    Write-Host "`n检测到用户取消操作，启动优雅退出流程..."
    
    # 执行自定义清理操作
    Write-Host "清理任务资源、保存运行状态..."
    
    # 设置Cancel为true，阻止系统强制终止进程
    $EventArgs.Cancel = $true
    
    exit 1
}

Write-Host "任务正在执行..."

# 模拟长时间运行的任务逻辑
while ($true) {
    Write-Host "任务运行中..."
    Start-Sleep -Seconds 1
}

# 任务正常完成时取消事件注册（实际取消场景不会执行到此处）
Unregister-Event -SourceIdentifier $eventHandler.Name

在Azure DevOps的PowerShell任务中，上述两种方式均可正常捕获用户取消触发的Ctrl+C信号，实现优雅退出。

内容的提问来源于Stack Exchange，提问作者Seva Alekseyev