.NET 7集成测试：如何为单测配置特定IFileSystem Mock？

要在测试级别替换IFileSystem的Mock同时保留IoC容器的使用，有两种常用的优雅方案：

方案一：让CustomWebApplicationFactory支持测试级别的服务配置 #

通过给工厂类添加自定义配置入口，允许每个测试传入专属的服务注册逻辑，覆盖默认的Mock。

1. 修改CustomWebApplicationFactory #

添加构造函数参数接收测试级别的服务配置委托，在ConfigureTestServices中先注册默认Mock，再应用测试的自定义配置：

public class CustomWebApplicationFactory : WebApplicationFactory<Program>
{
    private readonly Action<IServiceCollection>? _testServiceConfig;

    // 允许测试传入自定义服务配置
    public CustomWebApplicationFactory(Action<IServiceCollection>? testServiceConfig = null)
    {
        _testServiceConfig = testServiceConfig;
    }

    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureTestServices(services =>
        {
            // 注册默认的IFileSystem Mock（可选，根据需求设置基础行为）
            var defaultMock = new Mock<IFileSystem>();
            // defaultMock.Setup(fs => fs.SomeMethod()).Returns(...);
            services.AddScoped<IFileSystem>(_ => defaultMock.Object);

            // 应用测试专属的配置，覆盖默认设置
            _testServiceConfig?.Invoke(services);
        });
    }
}

2. 在测试方法中使用自定义Mock #

每个测试可以单独创建工厂实例，传入针对当前测试的IFileSystem Mock配置：

[Test]
public void Test1_WithCustomFileSystemMock()
{
    // 创建当前测试专属的IFileSystem Mock
    var testMock = new Mock<IFileSystem>();
    testMock.Setup(fs => fs.ReadAllText(It.IsAny<string>())).Returns("测试专属内容");
    // 按需添加其他Mock行为...

    // 实例化工厂时传入自定义服务配置，替换默认的IFileSystem
    using var factory = new CustomWebApplicationFactory(services =>
    {
        // 移除已注册的IFileSystem服务
        var existingDescriptor = services.SingleOrDefault(d => d.ServiceType == typeof(IFileSystem));
        if (existingDescriptor != null)
        {
            services.Remove(existingDescriptor);
        }
        // 注册测试用的Mock
        services.AddScoped<IFileSystem>(_ => testMock.Object);
    });

    using var scope = factory.Services.CreateScope();
    var serviceUnderTest = scope.ServiceProvider.GetRequiredService<ClassToTest>();

    // 执行测试逻辑并断言
    // ...

    Assert.IsTrue(true);
}

这种方案的优势是每个测试的依赖完全隔离，避免测试间的状态污染，同时保留了IoC容器的自动注入能力。

方案二：使用包装类动态替换Mock #

如果不想每个测试都重新创建工厂，可以通过包装类在已有的Scope中动态替换IFileSystem的实现。

1. 定义包装类 #

创建一个实现IFileSystem的包装类，内部持有可替换的实际实例：

public class FileSystemWrapper : IFileSystem
{
    // 允许动态替换内部的IFileSystem实例
    public IFileSystem InnerFileSystem { get; set; }

    // 实现IFileSystem的所有方法，转发给InnerFileSystem
    public string ReadAllText(string path) => InnerFileSystem.ReadAllText(path);
    // 实现其他IFileSystem方法，同理转发...
}

2. 修改工厂的服务注册 #

在CustomWebApplicationFactory中注册包装类，并将IFileSystem映射到这个包装类：

protected override void ConfigureWebHost(IWebHostBuilder builder)
{
    builder.ConfigureTestServices(services =>
    {
        // 注册默认的IFileSystem Mock
        var defaultMock = new Mock<IFileSystem>();
        // defaultMock.Setup(...);

        // 注册包装类，初始使用默认Mock
        services.AddScoped<FileSystemWrapper>(sp => new FileSystemWrapper
        {
            InnerFileSystem = defaultMock.Object
        });
        // 将IFileSystem映射到包装类
        services.AddScoped<IFileSystem>(sp => sp.GetRequiredService<FileSystemWrapper>());
    });
}

3. 在测试中替换Mock #

在测试方法中获取包装类，直接替换内部的InnerFileSystem为当前测试的Mock：

[Test]
public void Test2_DynamicMockReplacement()
{
    // 创建测试专属Mock
    var testMock = new Mock<IFileSystem>();
    testMock.Setup(fs => fs.Exists(It.IsAny<string>())).Returns(true);

    // 获取包装类并替换内部实例
    var wrapper = _scope.ServiceProvider.GetRequiredService<FileSystemWrapper>();
    wrapper.InnerFileSystem = testMock.Object;

    var serviceUnderTest = _scope.ServiceProvider.GetRequiredService<ClassToTest>();

    // 执行测试逻辑
    // ...

    Assert.IsTrue(true);
}

这种方案适合测试间共享大部分依赖，仅需替换个别服务的场景，但要注意测试间的隔离（比如在TearDown中恢复默认Mock，避免影响后续测试）。

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