ASP.NET集成测试中WebApplicationFactory创建的测试客户端能否共享？

你遇到的性能骤降，本质是XUnit并行运行时，每个测试类默认会创建独立的WebApplicationFactory实例——多个工厂同时启动进程内测试服务器，会触发资源竞争（比如端口占用、服务初始化锁），导致CreateClient调用陷入等待。

• 完全可行：WebApplicationFactory设计时就支持复用，单个工厂实例可以创建多个客户端，复用能彻底避免重复初始化测试服务器的开销。
• 线程安全：
  • WebApplicationFactory.CreateClient()方法本身是线程安全的；
  • 工厂创建的HttpClient实例，只要不修改其默认的HttpMessageHandler（测试场景下默认不会改），也是线程安全的，并行测试共用同一个客户端实例没问题。

1. 跨测试类共享WebApplicationFactory（推荐） #

用XUnit的ICollectionFixture实现全局共享工厂，这是官方推荐的复用方式：

第一步：定义共享夹具 #

public class SharedWebAppFixture : WebApplicationFactory<Program>
{
    // 自定义测试环境配置，比如替换数据库为内存库
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.UseEnvironment("Testing");
        builder.ConfigureServices(services =>
        {
            // 示例：替换EF Core数据库为内存库
            var descriptor = services.SingleOrDefault(
                d => d.ServiceType == typeof(DbContextOptions<AppDbContext>));
            if (descriptor != null) services.Remove(descriptor);
            
            services.AddDbContext<AppDbContext>(options =>
                options.UseInMemoryDatabase("TestDb"));
        });
    }
}

第二步：标记测试集合 #

[CollectionDefinition("SharedWebAppCollection")]
public class SharedWebAppCollection : ICollectionFixture<SharedWebAppFixture>
{
    // 空类，仅用于标记集合关联夹具
}

第三步：测试类绑定集合 #

[Collection("SharedWebAppCollection")]
public class UserApiTests
{
    private readonly HttpClient _client;

    // 构造函数注入共享夹具，创建客户端
    public UserApiTests(SharedWebAppFixture fixture)
    {
        _client = fixture.CreateClient();
    }

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

所有绑定该集合的测试类，会共用同一个SharedWebAppFixture实例，避免重复启动测试服务器。

2. 极致优化：共享单个HttpClient实例 #

如果想彻底消除CreateClient的调用开销，可以在夹具中预创建一个全局客户端：

public class SharedWebAppFixture : WebApplicationFactory<Program>
{
    public HttpClient SharedClient { get; }

    public SharedWebAppFixture()
    {
        SharedClient = CreateClient();
    }

    // 测试结束后自动清理资源
    protected override void Dispose(bool disposing)
    {
        if (disposing)
        {
            SharedClient.Dispose();
        }
        base.Dispose(disposing);
    }

    // 配置WebHost...
}

测试类直接使用预创建的客户端：

[Collection("SharedWebAppCollection")]
public class OrderApiTests
{
    private readonly HttpClient _client;

    public OrderApiTests(SharedWebAppFixture fixture)
    {
        _client = fixture.SharedClient;
    }

    // 测试方法...
}

• 测试隔离性：共享工厂/客户端时，必须保证测试之间无状态污染。比如每个测试前重置内存数据库、使用独立的测试用户会话。
• 并行与串行权衡：同一个XUnit集合内的测试是串行执行的。如果需要保持部分并行，可以将测试拆分到多个集合（每个集合对应一个共享夹具），但这会增加服务器初始化次数，需根据测试场景平衡。
• 资源清理：夹具会在所有测试完成后自动执行Dispose，务必在其中清理所有自定义资源（比如数据库连接、HttpClient）。

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