如何在FastEndpoints与.NET 8集成测试中替换为内存数据库？

问题场景 #

使用.NET 8 Minimal API结合FastEndpoints框架开发项目，核心配置通过ConfigureApp扩展方法串联，其中ConfigureDatabase注册了真实数据库（如SQL Server）。编写集成测试时需要将真实数据库替换为内存数据库，但FastEndpoints的AppFixture<Program>提供的ConfigureApp方法接收IWebHostBuilder参数，无法直接覆盖项目中WebApplicationBuilder层面的数据库配置，导致真实数据库和内存数据库的配置同时生效，达不到测试预期。

解决方案 #

方案一：通过替换服务注册覆盖DbContext #

利用AppFixture的ConfigureServices方法，移除已注册的真实DbContext服务，重新注册内存版本：

1. 项目侧的ConfigureDatabase保持原有真实数据库注册

public static WebApplicationBuilder ConfigureDatabase(this WebApplicationBuilder builder)
{
    builder.Services.AddDbContext<AppDbContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

    return builder;
}

2. 测试侧的BeeHiveApiFixture重写ConfigureServices

public class BeeHiveApiFixture : AppFixture<Program>
{
    protected override void ConfigureServices(IServiceCollection services)
    {
        // 移除已注册的AppDbContext配置
        var dbContextDescriptor = services.SingleOrDefault(d => 
            d.ServiceType == typeof(DbContextOptions<AppDbContext>));
        
        if (dbContextDescriptor != null)
        {
            services.Remove(dbContextDescriptor);
        }

        // 注册内存数据库版本的DbContext
        services.AddDbContext<AppDbContext>(options =>
            options.UseInMemoryDatabase("BeeHiveTestDb"));
    }
}

方案二：基于环境/配置的条件化数据库配置 #

通过环境标识或配置项，让项目的ConfigureDatabase自动切换数据库类型：

1. 修改项目侧的ConfigureDatabase方法

public static WebApplicationBuilder ConfigureDatabase(this WebApplicationBuilder builder)
{
    var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
    
    // 根据测试环境或配置项选择数据库
    if (builder.Environment.IsEnvironment("Testing") || connectionString == "UseInMemory")
    {
        builder.Services.AddDbContext<AppDbContext>(options =>
            options.UseInMemoryDatabase("BeeHiveTestDb"));
    }
    else
    {
        builder.Services.AddDbContext<AppDbContext>(options =>
            options.UseSqlServer(connectionString));
    }

    return builder;
}

2. 测试侧的BeeHiveApiFixture配置测试环境或覆盖配置

public class BeeHiveApiFixture : AppFixture<Program>
{
    protected override void ConfigureApp(IWebHostBuilder builder)
    {
        // 设置测试环境
        builder.UseEnvironment("Testing");

        // 或直接覆盖连接字符串配置
        builder.ConfigureAppConfiguration(config =>
        {
            config.AddInMemoryCollection(new Dictionary<string, string>
            {
                ["ConnectionStrings:DefaultConnection"] = "UseInMemory"
            });
        });
    }
}

原理说明 #

• FastEndpoints的AppFixture在启动测试应用时，会先执行项目中WebApplicationBuilder的配置，再执行ConfigureServices或ConfigureApp中的测试配置。
• 方案一通过移除原有服务再重新注册的方式，直接覆盖DbContext的依赖注入项；方案二则通过环境或配置开关，让项目代码自动适配测试场景，避免重复的服务替换逻辑。

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