使用Xunit搭配Sqlite时数据库初始化失败，如何编写测试项目初始化器？

核心适配逻辑说明 #

主项目的初始化器通常适配正式环境使用的数据库（如SQL Server、PostgreSQL），依赖专属的迁移逻辑、数据库连接管理规则，和Sqlite内存库的生命周期特性不兼容，因此需要针对性调整初始化流程。

具体实现步骤 #

1. 定义测试数据库Fixture管理Sqlite连接生命周期 #

Sqlite内存数据库的生命周期和数据库连接强绑定，连接关闭后数据会直接销毁，因此需要用Fixture保持连接全程打开，供所有测试用例复用：

public class TestDatabaseFixture : IDisposable
{
    private readonly DbConnection _sqliteConnection;

    public TestDatabaseFixture()
    {
        // 初始化Sqlite内存库连接
        _sqliteConnection = new SqliteConnection("DataSource=:memory:");
        _sqliteConnection.Open();
    }

    public void Dispose()
    {
        _sqliteConnection.Dispose();
    }

    // 对外提供DbContext实例构造方法
    public AppDbContext CreateDbContext()
    {
        var contextOptions = new DbContextOptionsBuilder<AppDbContext>()
            .UseSqlite(_sqliteConnection)
            .Options;
        return new AppDbContext(contextOptions);
    }
}

2. 抽取公共种子数据逻辑 #

将原主项目初始化器中的种子数据插入逻辑抽取为独立静态方法，主项目和测试项目可以共用，避免重复编码：

// 可放在主项目的公共工具类中，测试项目直接引用
public static class DatabaseSeedHelper
{
    public static void LoadSeedData(AppDbContext dbContext)
    {
        // 此处直接复用你原有初始化器中的数据插入逻辑
        if (!dbContext.Movies.Any())
        {
            dbContext.Movies.AddRange(new List<Movie>
            {
                // 原有种子数据
            });
            dbContext.SaveChanges();
        }
    }
}

3. 测试类集成Fixture执行初始化 #

在Xunit测试类中通过IClassFixture复用数据库实例，构造函数中执行库结构生成和种子数据加载流程：

// 声明复用Fixture，同一测试类下的所有用例共用同一个数据库
public class MovieApiTests : IClassFixture<TestDatabaseFixture>
{
    private readonly TestDatabaseFixture _dbFixture;

    public MovieApiTests(TestDatabaseFixture dbFixture)
    {
        _dbFixture = dbFixture;
        // 执行初始化流程
        using var testDbContext = _dbFixture.CreateDbContext();
        // 跳过和正式数据库绑定的迁移，直接生成表结构
        testDbContext.Database.EnsureCreated();
        // 加载种子数据
        DatabaseSeedHelper.LoadSeedData(testDbContext);
    }

    [Fact]
    public void YourTestLogic()
    {
        using var dbContext = _dbFixture.CreateDbContext();
        // 编写测试逻辑即可
    }
}

常见异常排查 #

• 表不存在报错：检查Sqlite连接是否在初始化前提前关闭，EnsureCreated执行时连接是否处于打开状态
• 测试数据污染：可以在每个测试用例执行完成后手动清空表数据，或者用TransactionScope包裹测试逻辑，执行完直接回滚事务

内容的提问来源于stack exchange，提问作者Pedro Henrique Franchi