ASP.NET Core 2.2集成测试中替换Autofac依赖的问题

我完全懂你的困扰——用Autofac的ASP.NET Core项目做集成测试时，本来想复用真实Startup类却替换特定依赖，结果发现ConfigureTestServices根本压不过Autofac的注册。这确实是ASP.NET Core 2.2的生命周期顺序问题：ConfigureTestServices会在Startup.ConfigureContainer之前执行，而Autofac的注册会直接覆盖之前服务集合里的同名服务。

下面给你两种直接可行的解决方案：

方案一：直接在测试中配置Autofac容器（推荐，无需修改生产代码） #

利用Autofac的注册覆盖特性，在测试的WebHostBuilder中添加ConfigureContainer方法，直接向Autofac容器注册你的Mock实现。因为这个配置会在Startup.ConfigureContainer之后执行，所以它的注册会覆盖掉生产代码里的真实实现。

修改后的测试类代码如下：

public abstract class ComponentTestFeature : Feature 
{ 
    protected HttpClient HttpClient { get; } 

    protected ComponentTestFeature() 
    { 
        var configuration = new ConfigurationBuilder() 
            .AddJsonFile("appsettings.Test.json") 
            .Build(); 

        var webHostBuilder = new WebHostBuilder() 
            .ConfigureServices(services => services.AddAutofac()) 
            .UseConfiguration(configuration) 
            .UseStartup<Startup>()
            // 关键：添加Autofac容器配置，覆盖原注册
            .ConfigureContainer<ContainerBuilder>(builder => 
            {
                // 注册Mock实现，注意生命周期要和原注册保持一致（这里是Scoped）
                builder.RegisterType<MockEventStoreManager>()
                       .As<IEventStoreManager>()
                       .InstancePerLifetimeScope();
            }); 

        var server = new TestServer(webHostBuilder); 
        HttpClient = server.CreateClient(); 
        var myService = server.Host.Services.GetRequiredService<IEventStoreManager>(); 
    } 
}

原理说明 #

Autofac默认会用最后注册的服务实现来解析对应的接口（除非你手动指定PreserveExistingDefaults()）。测试里的ConfigureContainer是在Startup.ConfigureContainer之后执行的，所以这里的Mock注册会直接覆盖掉生产代码里的EventStoreManager注册。

方案二：修改Startup类支持测试扩展（适合多依赖替换场景） #

如果你需要频繁替换多个Autofac注册，可以给Startup添加一个可选的配置委托，让测试代码能在容器构建时注入自定义逻辑。

首先修改生产的Startup类：

public class Startup 
{
    private readonly IConfiguration _configuration;
    private readonly Action<ContainerBuilder> _additionalContainerConfig;

    // 生产环境用的构造函数
    public Startup(IConfiguration configuration) : this(configuration, null)
    {
    }

    // 测试环境用的构造函数，允许传入额外的容器配置
    public Startup(IConfiguration configuration, Action<ContainerBuilder> additionalContainerConfig)
    {
        _configuration = configuration;
        _additionalContainerConfig = additionalContainerConfig;
    }

    public void ConfigureServices(IServiceCollection services) 
    { 
        services 
            .AddMvc() 
            .SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 
    } 

    public void ConfigureContainer(ContainerBuilder builder) 
    { 
        // 生产环境的基础注册
        builder.RegisterType<EventStoreManager>().As<IEventStoreManager>();
        
        // 执行测试传入的额外配置，覆盖原有注册
        _additionalContainerConfig?.Invoke(builder);
    }

    // Configure方法保持不变...
}

然后在测试中，直接实例化带有自定义配置的Startup：

public abstract class ComponentTestFeature : Feature 
{ 
    protected HttpClient HttpClient { get; } 

    protected ComponentTestFeature() 
    { 
        var configuration = new ConfigurationBuilder() 
            .AddJsonFile("appsettings.Test.json") 
            .Build(); 

        var webHostBuilder = new WebHostBuilder() 
            .ConfigureServices(services => services.AddAutofac()) 
            .UseConfiguration(configuration) 
            // 使用自定义Startup实例，传入Mock注册逻辑
            .UseStartup(() => new Startup(configuration, builder => 
            {
                builder.RegisterType<MockEventStoreManager>().As<IEventStoreManager>();
            })); 

        var server = new TestServer(webHostBuilder); 
        HttpClient = server.CreateClient(); 
        var myService = server.Host.Services.GetRequiredService<IEventStoreManager>(); 
    } 
}

适用场景 #

这种方法需要修改生产代码，但好处是可以集中管理多个依赖的替换逻辑，适合复杂的集成测试场景。

为什么原来的方法失效？ #

再明确一下根本原因：在ASP.NET Core 2.2的WebHost构建流程中，执行顺序是：

1. WebHostBuilder.ConfigureServices（包括AddAutofac）
2. Startup.ConfigureServices
3. ConfigureTestServices（你的测试代码里的注册）
4. Startup.ConfigureContainer（Autofac的真实服务注册）

因为Autofac的注册是在最后一步，所以它会覆盖掉之前服务集合中所有同名的服务注册，导致你通过ConfigureTestServices添加的Mock被覆盖了。

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