如何为NUnit项目设置全局总超时时间并中断超时测试执行

NUnit本身没有提供原生的全局总超时配置项，但可以通过自定义逻辑实现所有测试总运行时长的限制，达到超时即中断测试的效果。以下是两种可行的实现方式：

方案一：装配级别Fixture监控总时长 #

利用NUnit 3+支持的TestAssemblyFixture特性，创建全局监控类，在测试启动时记录开始时间，通过后台线程实时监控总耗时，超过阈值时立即终止测试运行。

示例代码：

using System;
using System.Threading;
using NUnit.Framework;
using NUnit.Framework.Internal;

[TestAssemblyFixture]
public class GlobalTimeoutMonitor : IDisposable
{
    private readonly TimeSpan _totalTimeout = TimeSpan.FromHours(1);
    private DateTime _startTime;
    private Thread _monitorThread;
    private bool _disposed;

    [OneTimeSetUp]
    public void Setup()
    {
        _startTime = DateTime.Now;
        _monitorThread = new Thread(MonitorTimeout) { IsBackground = true };
        _monitorThread.Start();
    }

    private void MonitorTimeout()
    {
        while (!_disposed)
        {
            if (DateTime.Now - _startTime > _totalTimeout)
            {
                TestExecutionContext.CurrentContext.StopRun("全局总超时触发，终止测试运行");
                break;
            }
            Thread.Sleep(1000); // 每秒检查一次，可按需调整间隔
        }
    }

    public void Dispose()
    {
        _disposed = true;
        _monitorThread?.Join();
    }
}

将该类放入测试项目中，NUnit会自动在装配初始化时启动监控，一旦总运行时长超过设定阈值，就会调用StopRun()终止所有剩余测试，已完成的测试结果会正常保留。

方案二：自定义TestEventListener监听测试事件 #

实现NUnit的ITestEventListener接口，监听测试运行的生命周期事件，在测试集启动时记录开始时间，每次事件触发时检查总耗时，超过阈值则终止运行。

示例代码：

using System;
using NUnit.Framework.Interfaces;
using NUnit.Framework.Internal;

public class GlobalTimeoutListener : ITestEventListener
{
    private static DateTime? _startTime;
    private readonly TimeSpan _totalTimeout = TimeSpan.FromHours(1);

    public void OnTestEvent(string report)
    {
        var testEvent = TestEvent.FromXml(report);
        
        // 记录测试集启动时间
        if (testEvent.EventType == "TestSuiteStart" && testEvent.TestId == TestExecutionContext.CurrentContext.Test.ID)
        {
            _startTime = DateTime.Now;
        }

        // 每次事件触发时检查总耗时
        if (_startTime.HasValue && DateTime.Now - _startTime.Value > _totalTimeout)
        {
            TestExecutionContext.CurrentContext.StopRun("全局总超时触发，终止测试运行");
        }
    }
}

随后在NUnit配置文件（nunit.config）中注册该监听器：

<nunit>
  <listeners>
    <add type="你的命名空间.GlobalTimeoutListener, 你的测试程序集名称" />
  </listeners>
</nunit>

补充说明 #

• 若使用NUnit控制台运行测试，也可结合外部脚本（如PowerShell、Bash）设置进程超时，到点直接终止nunit-console进程，但这种方式无法优雅保留已完成测试的结果，仅作为备选方案。
• 后台线程的检查间隔可根据需求调整，间隔越小监控越灵敏，但会增加少量性能开销。

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