如何在NUnit测试中实现静态测试本地数据及单测请求上下文隔离？

我来帮你解决这个问题！针对你维护类库NUnit测试时，需要为每个测试提供独立、可跨任务流转的请求上下文，以及实现静态“测试本地”数据的需求，这里有一套经过实践验证的方案：

核心思路是利用AsyncLocal<T>来存储上下文（它能在异步调用链中保持数据隔离），结合NUnit的测试生命周期方法来初始化/清理每个测试的上下文。

1. 创建上下文持有者类 #

这个类负责静态提供当前请求上下文，同时通过AsyncLocal<T>确保每个测试的上下文完全隔离，即使测试包含异步操作也能跨任务访问：

public static class RequestContextHolder
{
    // AsyncLocal会自动隔离不同测试的执行上下文数据
    private static readonly AsyncLocal<IRequestContext> _currentContext = new AsyncLocal<IRequestContext>();

    public static IRequestContext Current
    {
        get => _currentContext.Value ?? throw new InvalidOperationException("请求上下文未初始化，请确保测试已执行SetUp");
        set => _currentContext.Value = value;
    }
}

2. 编写测试基类管理上下文生命周期 #

通过NUnit的[SetUp]和[TearDown]属性，确保每个测试运行前创建独立的上下文，运行后清理：

public class RequestContextTestBase
{
    [SetUp]
    public void InitializeRequestContext()
    {
        // 这里可以替换为类库使用者提供的上下文实现，或者默认测试实现
        var testContext = new TestRequestContext();
        RequestContextHolder.Current = testContext;
    }

    [TearDown]
    public void CleanupRequestContext()
    {
        // 清理上下文，避免影响后续测试
        RequestContextHolder.Current = null;
    }
}

3. 适配类库的上下文获取接口 #

如果你的类库是通过使用者提供的IRequestContextAccessor接口获取上下文，只需实现一个测试用的Accessor，指向我们的持有者类：

public class TestRequestContextAccessor : IRequestContextAccessor
{
    public IRequestContext GetCurrentContext()
    {
        return RequestContextHolder.Current;
    }
}

在测试初始化时，把这个Accessor注入到类库的依赖中（比如通过DI容器替换，或者直接设置静态依赖）即可。

其实上面的AsyncLocal<T>已经完美实现了“静态测试本地”数据的需求：

• 它是静态可访问的：通过RequestContextHolder.Current直接获取
• 它是测试隔离的：每个测试的AsyncLocal值完全独立，并行测试也不会互相干扰
• 支持跨任务流转：即使测试中使用await、Task.Run等异步操作，上下文也能在整个调用链中保持一致

如果需要存储更通用的测试本地静态数据（非请求上下文），可以复用同样的模式：

public static class TestLocalData
{
    private static readonly AsyncLocal<Dictionary<string, object>> _data = new AsyncLocal<Dictionary<string, object>>();

    public static T Get<T>(string key)
    {
        var dict = _data.Value ?? throw new InvalidOperationException("测试本地数据未初始化");
        return (T)dict[key];
    }

    public static void Set<T>(string key, T value)
    {
        if (_data.Value == null)
            _data.Value = new Dictionary<string, object>();
        
        _data.Value[key] = value;
    }
}

然后在测试基类的SetUp中初始化，TearDown中清理即可。

所有需要使用请求上下文的测试，只需继承我们的基类，就能直接使用独立上下文：

[TestFixture]
public class MyLibraryTests : RequestContextTestBase
{
    [Test]
    public async Task ProcessData_WithContext_UsesCorrectValues()
    {
        // 给当前测试的上下文设置数据
        var currentContext = RequestContextHolder.Current;
        currentContext.UserId = "test-user-123";

        // 调用类库方法（内部会通过Accessor获取上下文）
        var result = await MyLibrary.ProcessUserAsync();

        Assert.That(result.UserId, Is.EqualTo("test-user-123"));
    }

    [Test]
    public void CalculateValue_DifferentContext_IsIsolated()
    {
        var currentContext = RequestContextHolder.Current;
        currentContext.ConfigValue = 42;

        var result = MyLibrary.CalculateConfiguredValue();

        Assert.That(result, Is.EqualTo(42));
    }
}

关键注意事项 #

• 不要用ThreadLocal<T>代替AsyncLocal<T>：ThreadLocal只能在单个线程中保持数据，无法支持异步测试的跨任务流转
• 务必使用[SetUp]/[TearDown]而非[OneTimeSetUp]/[OneTimeTearDown]：后者是针对整个测试夹具（TestFixture）的，会导致多个测试共享同一个上下文
• 并行测试兼容：NUnit的并行测试模式下，AsyncLocal会自动隔离每个测试的执行上下文，不需要额外配置

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