使用NSubstitute在C#中模拟静态类及方法报错，求解决方案？

云原生阿岚

2026-5-6

嘿，这个问题我之前踩过坑！NSubstitute（包括大部分.NET主流Mock框架）确实没法直接Mock静态类/静态方法——毕竟静态成员不属于任何对象实例，Mock框架的核心是基于实例的代理生成。给你两个靠谱的解决思路：

方案一：重构为可注入的服务（最推荐）

这是遵循依赖倒置原则的标准做法，从根源上解耦静态依赖，后续测试和扩展都更灵活：

定义抽象接口
先把静态方法的行为抽象成一个接口：

public interface IFileGenerator
{
    Task GenerateExcelFile<T>(string filename, IEnumerable<T> content);
}

改造原有静态类为接口实现
把原来的静态逻辑移到实例类里，或者直接让静态类实现接口（不过更建议新建独立的实现类，避免静态残留）：

public class FileGenerator : IFileGenerator
{
    public async Task GenerateExcelFile<T>(string filename, IEnumerable<T> content)
    {
        // 这里放原来静态方法里的所有逻辑
    }
}

业务类依赖接口而非静态类
在需要生成Excel的业务代码中，通过构造函数注入IFileGenerator：

public class OrderService
{
    private readonly IFileGenerator _fileGenerator;

    // 注入接口，而非直接调用静态方法
    public OrderService(IFileGenerator fileGenerator)
    {
        _fileGenerator = fileGenerator;
    }

    public async Task ExportOrdersToExcel(string filePath, IEnumerable<Order> orders)
    {
        await _fileGenerator.GenerateExcelFile(filePath, orders);
    }
}

单元测试中Mock接口
现在就可以用NSubstitute轻松Mock了：

// 创建Mock实例
var mockFileGenerator = Substitute.For<IFileGenerator>();
// 模拟方法调用的返回（这里让它返回已完成的Task）
mockFileGenerator.GenerateExcelFile("test.xlsx", Arg.Any<IEnumerable<Order>>())
                 .Returns(Task.CompletedTask);

// 把Mock注入到业务类
var orderService = new OrderService(mockFileGenerator);
// 执行测试逻辑
await orderService.ExportOrdersToExcel("test.xlsx", new List<Order>());

// 验证方法是否被正确调用
await mockFileGenerator.Received().GenerateExcelFile("test.xlsx", Arg.Any<IEnumerable<Order>>());

方案二：用隔离框架Shim静态方法（无需重构的临时方案）

如果暂时不想动原有代码，可以用Visual Studio Enterprise版自带的Microsoft Fakes来Shim静态方法（相当于直接拦截静态方法的调用）：

// 包裹在ShimsContext中，确保测试后环境恢复
using (ShimsContext.Create())
{
    // Shim静态方法，让它执行我们指定的逻辑（这里直接返回空Task）
    ShimFileGenerator.GenerateExcelFileStringIEnumerableOfT = (filename, content) => Task.CompletedTask;

    // 执行你的测试代码，此时调用FileGenerator.GenerateExcelFile会走Shim逻辑，不会真的生成文件
    await YourTestMethodThatCallsStaticExcelGenerator();
}

⚠️ 注意：这个方案属于黑盒式的拦截，耦合度很高，后续重构静态类的方法签名时，测试很容易失效，仅建议作为临时过渡方案。

总的来说，还是优先推荐方案一——静态类虽然写起来省事，但在需要单元测试的场景下，会严重限制代码的可测试性，通过接口抽象解耦才是长期的最佳实践。

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