如何修复ASP.NET Core 6 MVC XUnit单元测试的Configure方法缺失异常

推荐方案：使用WebApplicationFactory<T> #

ASP.NET Core 6+官方推荐用WebApplicationFactory<T>创建测试服务器，它能自动适配Program.cs的配置逻辑，避免手动处理WebHostBuilder的约定问题。

步骤1：创建自定义测试工厂 #

在测试项目中新增一个继承自WebApplicationFactory<Program>的类：

public class CustomWebApplicationFactory : WebApplicationFactory<Program>
{
    // 如需自定义测试环境配置，可重写以下方法
    protected override IWebHostBuilder CreateWebHostBuilder()
    {
        return WebHost.CreateDefaultBuilder()
            .UseStartup<Program>();
    }
}

步骤2：编写测试方法 #

在测试类中通过IClassFixture注入工厂，创建HttpClient发起测试请求：

public class HomePageTests : IClassFixture<CustomWebApplicationFactory>
{
    private readonly HttpClient _client;

    public HomePageTests(CustomWebApplicationFactory factory)
    {
        _client = factory.CreateClient();
    }

    [Fact]
    public async Task LoadIndexPageTest()
    {
        // 请求主页
        var response = await _client.GetAsync("/");
        
        // 验证响应状态
        response.EnsureSuccessStatusCode();
        
        // 可选：验证页面内容包含预期文本
        var content = await response.Content.ReadAsStringAsync();
        Assert.Contains("Home Page", content);
    }
}

备选方案：调整Program.cs暴露配置方法 #

如果坚持使用WebHostBuilder，需要修改Program.cs，将请求管道配置逻辑提取为公共的Configure方法，满足WebHostBuilder的约定要求：

修改Program.cs #

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;

namespace YourAppNamespace;

public class Program
{
    public static void Main(string[] args)
    {
        var host = CreateHostBuilder(args).Build();
        host.Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Program>();
            });

    // 新增公共Configure方法，供WebHostBuilder调用
    public void Configure(IApplicationBuilder app)
    {
        // 原有的请求管道配置代码，示例：
        if (app.Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
            app.UseHsts();
        }
        app.UseHttpsRedirection();
        app.UseStaticFiles();
        app.UseRouting();
        app.UseAuthorization();
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllerRoute(
                name: "default",
                pattern: "{controller=Home}/{action=Index}/{id?}");
            endpoints.MapAreaControllerRoute(
                name: "Admin",
                areaName: "Admin",
                pattern: "Admin/{controller=Home}/{action=Index}/{id?}");
        });
    }

    // 保留公共的ConfigureServices方法（原有服务注册逻辑）
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllersWithViews();
        // 其他服务注册代码
    }
}

调整测试代码 #

[Fact]
public async Task LoadIndexPageTest()
{
    var server = new TestServer(new WebHostBuilder()
        .UseStartup<Program>());
    
    var client = server.CreateClient();
    var response = await client.GetAsync("/");
    
    response.EnsureSuccessStatusCode();
}

问题原因 #

ASP.NET Core 6的Program.cs无论是顶级语句模式还是传统static void Main结构，若未显式暴露公共的Configure和ConfigureServices方法，WebHostBuilder会因找不到约定的配置入口抛出异常。WebApplicationFactory会自动处理这些底层细节，而手动调整Program.cs则是直接满足WebHostBuilder的约定要求。

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