如何在MSTest单元测试中处理Azure DevOps阶段取消事件？

我之前也遇到过完全一样的问题——Azure DevOps取消阶段时抛出的OperationCanceledException根本抓不到，后来才搞明白：这个异常是在dotnet vstest主进程层面抛出的，而不是在单个测试方法的执行流程里，所以你在测试方法里写的try/catch自然捕获不到。

要解决这个问题，我们需要在进程级别注册取消信号的处理逻辑，因为Azure DevOps的阶段取消本质是向测试进程发送了SIGINT（对应Windows的Ctrl+C）信号。下面是具体的实现方案：

1. 注册进程级取消信号处理 #

我们可以利用Console.CancelKeyPress事件来捕获SIGINT信号，这个事件会在进程收到取消信号时触发。最好在程序集初始化时注册这个事件，确保所有测试运行前就生效：

using System;
using Microsoft.VisualStudio.TestTools.UnitTesting;

[TestClass]
public class GlobalTestInitializer
{
    [AssemblyInitialize]
    public static void SetupGlobalHandlers(TestContext testContext)
    {
        // 注册SIGINT信号处理逻辑
        Console.CancelKeyPress += (sender, eventArgs) =>
        {
            // 阻止进程立即终止，给我们时间完成日志记录
            eventArgs.Cancel = true;

            // 记录取消事件到Azure DevOps日志
            testContext.WriteLine("⚠️ 捕获到Azure DevOps阶段取消信号！");
            testContext.WriteLine("正在记录取消事件详情...");

            // 这里可以添加自定义逻辑：比如写入外部日志文件、发送通知等
            // 注意：操作要尽量简短，因为Azure DevOps会在几秒后强制终止进程
            System.IO.File.WriteAllText("cancellation_log.txt", 
                $"取消时间：{DateTime.UtcNow:yyyy-MM-dd HH:mm:ss}\n来源：Azure DevOps阶段取消");
        };
    }
}

2. 编写测试类（无需修改原有逻辑） #

你的测试类可以正常编写，不需要额外的try/catch，因为取消信号的处理已经在全局层面完成了：

[TestClass]
public class SimpleTest
{
    public TestContext TestContext { get; set; }

    [TestMethod]
    public void SimpleTestMethod()
    {
        TestContext.WriteLine("测试开始执行...");
        
        // 模拟长时间运行的测试（方便验证取消场景）
        for (int i = 0; i < 15; i++)
        {
            TestContext.WriteLine($"测试步骤 {i+1}/15");
            System.Threading.Thread.Sleep(1000);
        }

        TestContext.WriteLine("测试执行完成");
    }
}

为什么这个方案有效？ #

当你在Azure DevOps中取消阶段时：

1. 代理会向dotnet vstest进程发送SIGINT信号
2. 我们注册的Console.CancelKeyPress事件会立即触发
3. 我们可以在事件处理逻辑中记录日志、执行清理操作
4. 设置eventArgs.Cancel = true会延迟进程终止，让我们有时间完成必要的操作（Azure DevOps最终会在约5秒后强制终止进程，所以逻辑要简洁）

关键注意事项 #

• 不要在单个测试方法内部处理取消信号：测试方法运行在子线程中，无法直接捕获主进程收到的SIGINT信号
• 利用TestContext输出日志：这样日志会直接显示在Azure DevOps的测试运行记录里，无需额外配置
• 避免耗时操作：Azure DevOps不会无限等待，复杂的IO操作可能来不及完成就被强制终止
• 日志文件路径：如果要写入文件，确保路径在代理的工作目录下（比如$(Agent.WorkFolder)），避免权限问题

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