TUnit框架中实现微服务集成测试的共享工厂模式实践

2025-06-26 22:58:46作者：瞿蔚英Wynne

在基于TUnit测试框架进行微服务集成测试时，开发团队经常面临一个共同挑战：如何在多个服务间共享基础测试设施，同时保持对特定服务启动类的灵活支持。本文将深入探讨这一问题的解决方案。

问题背景

现代微服务架构通常采用统一的基础框架来处理日志、消息队列、数据库等公共组件。当为这些服务编写集成测试时，每个测试都需要完整的环境初始化过程。直接为每个服务重复编写测试工厂类会导致大量冗余代码，而直接使用泛型又受到测试框架特性的限制。

技术挑战分析

TUnit作为现代化测试框架，虽然提供了丰富的特性，但在处理泛型类作为数据源时存在限制。具体表现为：

测试属性(如ClassDataSource)不支持使用未解析的泛型类型参数
无法通过父类泛型参数动态指定被测服务的启动类
共享测试基础设施的需求与特定服务配置之间存在矛盾

解决方案设计

基础工厂模式

首先建立抽象的Web应用工厂基类，封装所有公共组件的初始化逻辑：

public abstract class WebFactoryBase<TProgram> 
    : WebApplicationFactory<TProgram>, IAsyncInitializer 
    where TProgram : class
{
    // 实现共享的初始化逻辑
    // 包括日志、Kafka、数据库等基础设施配置
}

具体服务工厂实现

为每个微服务创建具体的工厂类，仅需指定不同的Program类型：

public class OrderServiceWebFactory : WebFactoryBase<OrderService.Program>
{
    // 可添加服务特定的配置
}

public class PaymentServiceWebFactory : WebFactoryBase<PaymentService.Program>
{
    // 可添加服务特定的配置
}

测试类设计

测试类可以通过多种方式使用这些工厂：

方案一：多数据源测试

[ClassDataSource<OrderServiceWebFactory>]
[ClassDataSource<PaymentServiceWebFactory>]
public class SharedIntegrationTests
{
    private readonly WebFactoryBase<Program> _factory;
    
    public SharedIntegrationTests(WebFactoryBase<Program> factory)
    {
        _factory = factory;
    }
    
    [Test]
    public async Task HealthCheck_ShouldReturnSuccess()
    {
        // 使用_factory进行测试
    }
}

方案二：服务专用测试基类

public abstract class OrderServiceTestsBase
{
    [ClassDataSource<OrderServiceWebFactory>]
    public required OrderServiceWebFactory Factory { get; init; }
    
    // 共享测试方法
}

public class OrderServiceSpecificTests : OrderServiceTestsBase
{
    [Test]
    public async Task PlaceOrder_ShouldSucceed()
    {
        // 使用Factory进行测试
    }
}