在.NET7中创建集成测试WebApplication Fixture时抛出异常

错误原因拆解 #

你遇到的两个异常存在关联：

• InvalidCastException：你的Fixture实际启动了Kestrel服务器，但测试代码尝试将其强制转换为TestServer类型，类型不匹配导致报错。
• 构造函数参数无匹配Fixture：测试类的构造函数依赖类型与注册的Fixture类型不匹配，或者Fixture定义不符合xUnit共享Fixture的要求。

修复步骤 #

1. 让Fixture正确继承WebApplicationFactory<T> #

自定义Fixture必须继承ASP.NET Core集成测试提供的WebApplicationFactory<T>（T为你的项目启动类，比如Program），它会自动管理TestServer，无需手动启动Kestrel。

错误示例（手动启动Kestrel导致类型不匹配）：

public class WebAppFixture : IDisposable
{
    private readonly IHost _host;
    public HttpClient Client { get; }

    public WebAppFixture()
    {
        var builder = WebApplication.CreateBuilder();
        // 配置服务...
        var app = builder.Build();
        _host = app.RunAsync().GetAwaiter().GetResult(); // 启动Kestrel
        Client = new HttpClient { BaseAddress = new Uri("http://localhost:5000") };
    }

    public void Dispose() => _host.Dispose();
}

正确示例（继承WebApplicationFactory<T>）：

public class WebAppFixture : WebApplicationFactory<Program>
{
    // 可选：重写ConfigureWebHost自定义测试配置
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureServices(services =>
        {
            // 替换测试用服务，比如内存数据库
            var descriptor = services.SingleOrDefault(d => d.ServiceType == typeof(DbContextOptions<AppDbContext>));
            if (descriptor != null) services.Remove(descriptor);
            services.AddDbContext<AppDbContext>(options => options.UseInMemoryDatabase("TestDb"));
        });
    }
}

2. 测试类正确绑定Fixture #

测试类需通过xUnit的IClassFixture<T>接口绑定自定义Fixture，构造函数参数类型必须与Fixture一致。

错误示例（参数类型不匹配）：

public class MyTests : IClassFixture<TestServer> // 错误：Fixture类型不匹配
{
    private readonly TestServer _server;

    public MyTests(TestServer server) // 错误：无对应Fixture提供TestServer实例
    {
        _server = server;
    }
}

正确示例（绑定自定义Fixture）：

public class MyTests : IClassFixture<WebAppFixture>
{
    private readonly HttpClient _client;

    public MyTests(WebAppFixture fixture)
    {
        _client = fixture.CreateClient(); // 通过Fixture获取TestServer对应的HttpClient
    }

    [Fact]
    public async Task TestEndpoint()
    {
        var response = await _client.GetAsync("/api/test");
        response.EnsureSuccessStatusCode();
    }
}

3. 禁止手动强制使用Kestrel #

如果在ConfigureWebHost中显式调用UseKestrel()，会覆盖默认的TestServer，导致类型转换错误。确保Fixture内不要手动设置UseKestrel()，WebApplicationFactory会自动使用TestServer。

错误配置示例：

protected override void ConfigureWebHost(IWebHostBuilder builder)
{
    builder.UseKestrel(); // 错误：强制替换为Kestrel服务器
}

4. 确保启动类Program可被测试项目访问 #

如果你的项目使用.NET 6+顶级语句编写Program，需要在主项目的.csproj文件中添加以下配置，让测试项目能访问Program类型：

<ItemGroup>
    <InternalsVisibleTo Include="你的测试项目名称" />
</ItemGroup>

额外注意点 #

• 若要在多个测试类间共享Fixture，可使用ICollectionFixture<T>，给测试类标记[Collection("WebAppCollection")]，并定义对应的集合类。
• 不要在Fixture内手动创建HttpClient，通过CreateClient()方法获取的实例会自动绑定TestServer地址，无需手动设置BaseAddress。

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