ASP.NET Core Web API集成测试报错：入口点未构建IHost

核心问题分析 #

你遇到的两个错误本质都是测试工厂与API启动逻辑的适配问题：

• System.InvalidOperationException: 'The entry point exited without ever building an IHost.'：WebApplicationFactory 无法找到正确的Host构建入口，或TestStartup的配置未完成Host初始化
• 404响应：测试环境下路由/中间件未正确注册，或服务替换导致控制器无法被识别

分步解决方案 #

1. 修正WebApplicationFactory实现 #

不要直接将TestStartup作为泛型参数传入，改为基于项目主入口Program构建，再通过配置覆盖替换测试所需服务：

public class ApiTestsBasicFactory : WebApplicationFactory<Program>
{
    // 若项目用ASP.NET Core 6+顶级语句，需在Program.cs末尾加 public partial class Program { } 让测试项目访问
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        // 替换DbContext为内存数据库
        builder.ConfigureServices(services =>
        {
            // 移除原有DbContext注册
            var dbDescriptor = services.SingleOrDefault(d => d.ServiceType == typeof(DbContextOptions<YourDbContext>));
            if (dbDescriptor != null) services.Remove(dbDescriptor);
            
            services.AddDbContext<YourDbContext>(options =>
                options.UseInMemoryDatabase("TestIntegrationDb"));

            // 替换Identity服务
            var identityDescriptor = services.SingleOrDefault(d => d.ServiceType == typeof(IUserStore<YourUser>));
            if (identityDescriptor != null) services.Remove(identityDescriptor);
            
            services.AddIdentityCore<YourUser>(options =>
            {
                // 测试环境放宽密码规则
                options.Password.RequireDigit = false;
                options.Password.RequireLowercase = false;
            }).AddEntityFrameworkStores<YourDbContext>();

            // 替换后台任务服务
            services.RemoveAll<IYourBackgroundTask>();
            services.AddScoped<IYourBackgroundTask, TestBackgroundTask>();
        });

        // 强制配置路由与中间件，避免404
        builder.Configure(app =>
        {
            var env = app.ApplicationServices.GetRequiredService<IWebHostEnvironment>();
            if (env.IsDevelopment()) app.UseDeveloperExceptionPage();
            
            app.UseRouting();
            app.UseAuthorization();
            app.UseEndpoints(endpoints => endpoints.MapControllers()); // 关键：确保控制器路由映射
        });
    }
}

2. 优化TestStartup（可选） #

如果必须保留TestStartup继承逻辑，需确保完整覆盖Host构建与中间件配置：

public class TestStartup : Startup
{
    public TestStartup(IConfiguration configuration) : base(configuration) { }

    public override void AddDbContext(IServiceCollection services)
    {
        services.AddDbContext<YourDbContext>(options =>
            options.UseInMemoryDatabase("TestDb"));
    }

    public override void AddIdentity(IServiceCollection services)
    {
        services.AddIdentityCore<YourUser>(options =>
        {
            // 测试环境配置
        }).AddEntityFrameworkStores<YourDbContext>();
    }

    public override void ConfigureBackgroundTasksDI(IServiceCollection services)
    {
        services.AddScoped<IYourBackgroundTask, TestBackgroundTask>();
    }

    // 必须重写Configure，确保中间件链完整
    public override void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        base.Configure(app, env); // 保留原项目中间件
        // 测试环境额外配置
    }
}

3. 修正测试基类的HttpClient初始化 #

确保用工厂内置方法创建Client，避免自定义构造导致的配置缺失：

[TestFixture]
public class ApiTestsBase
{
    protected WebApplicationFactory<Program> Factory { get; private set; }
    protected HttpClient Client { get; private set; }

    [OneTimeSetUp]
    public void OneTimeSetUp()
    {
        Factory = new ApiTestsBasicFactory();
        Client = Factory.CreateClient(new WebApplicationFactoryClientOptions
        {
            BaseAddress = new Uri("https://localhost:5001/") // 匹配测试服务地址，或留空使用默认
        });
    }

    [OneTimeTearDown]
    public void OneTimeTearDown()
    {
        Client.Dispose();
        Factory.Dispose();
    }
}

关键注意事项 #

• 若使用ASP.NET Core 6+顶级语句（Program.cs无显式Program类），必须在Program.cs末尾添加public partial class Program { }，让测试项目能访问入口类
• 替换服务时务必先移除原有注册，避免服务冲突
• 404问题优先检查：是否调用了UseEndpoints(endpoints => endpoints.MapControllers())、请求URL是否与控制器路由匹配

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