.NET测试基类最佳实践：如何复用WebApplicationFactory创建的HttpClient

结论 #

优先选择1. 抽象类在构造函数中完成初始化，该方案是.NET集成测试场景下复用WebApplicationFactory与HttpClient的最简洁通用方案，适配xUnit的Fixture生命周期规则，维护成本最低。

各方案对比 #

• 方案1：抽象基类实现
  • 优势：直接复用IClassFixture注入逻辑，所有继承基类的测试类无需重复编写WebApplicationFactory注入、HttpClient初始化代码；可统一封装公共请求、断言逻辑，所有子类直接调用即可；代码改动量最小，原有测试仅需调整继承关系即可适配。
  • 适用场景：绝大多数单测试项目、复用逻辑集中的测试场景。
• 方案2：组合模式实现
  • 优势：耦合度低于继承，可适配需要多逻辑复用的场景（C#不支持多类继承，若需同时复用多套无关测试逻辑时适用）。
  • 劣势：每个测试类都需要手动实例化公共类、暴露HttpClient或公共方法，重复代码量高于基类方案，复杂度更高。
• 其他优化方案：自定义WebApplicationFactory
  如果你需要全局统一配置测试环境（比如替换真实数据库为内存数据库、禁用外部服务依赖、全局添加测试请求头等），可以先自定义继承自WebApplicationFactory<Startup>的工厂类，再搭配抽象基类使用，复用性更强。

代码实现示例 #

注意点：修正原有HttpClient初始化逻辑 #

原有代码将HttpClient基地址设为/healthcheck会导致其他接口无法请求，基类初始化时需使用根地址，具体接口路径在测试方法中传入即可。

1. 自定义WebApplicationFactory（可选，需要全局配置测试环境时用） #

namespace API.Test;
public class CustomWebApplicationFactory : WebApplicationFactory<Startup>
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        // 这里可以统一配置测试环境，比如替换数据库、mock外部服务等
        builder.ConfigureServices(services =>
        {
            // 替换服务的逻辑写在这里
        });
    }
}

2. 编写抽象测试基类 #

namespace API.Test;
public abstract class IntegrationTestBase : IClassFixture<CustomWebApplicationFactory>
{
    protected readonly HttpClient TestClient;
    protected IntegrationTestBase(CustomWebApplicationFactory factory)
    {
        // 初始化根地址的HttpClient
        TestClient = factory.CreateDefaultClient(new Uri("http://localhost/"));
        // 也可以在这里统一加测试请求头，比如鉴权token
        // TestClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "测试token");
    }
}

3. 业务测试类继承基类直接使用 #

健康检查测试

namespace API.Test;
public class HealthCheckTests : IntegrationTestBase
{
    public HealthCheckTests(CustomWebApplicationFactory factory) : base(factory)
    {
    }
    [Fact]
    public async Task HealthCheck_ReturnsOk()
    {
        var response = await TestClient.GetAsync("/healthcheck");
        response.EnsureSuccessStatusCode();
    }
}

其他控制器测试

namespace API.Test;
public class ProductsControllerTests : IntegrationTestBase
{
    public ProductsControllerTests(CustomWebApplicationFactory factory) : base(factory)
    {
    }
    [Fact]
    public async Task GetProducts_ReturnsOk()
    {
        var response = await TestClient.GetAsync("/api/products");
        response.EnsureSuccessStatusCode();
    }
}

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