XUnit测试中同一DbContext下仓储与Http响应数据不符问题排查

你的核心问题是测试代码中使用的DbContext实例，与HttpClient请求管道中使用的DbContext实例，并未共享同一个InMemory数据库，或者数据未被正确持久化，导致两边数据互不可见。以下是具体原因和解决步骤：

核心原因拆解 #

1. 数据未持久化到InMemory数据库
   若你的RoleRepository.CreateAsync方法仅将实体添加到DbContext的跟踪集合中，但未调用SaveChangesAsync()，数据只会停留在当前DbContext的内存缓存里，不会写入InMemory数据库，其他DbContext实例自然无法读取。

2. InMemory数据库名称不一致
   你在TestFactory中用Guid.NewGuid().ToString()动态生成数据库名，但如果RemoveDbContext方法未正确移除原有DbContext配置，或者EnsureDbCreated的实现存在问题，可能导致测试类获取的DbContext与HttpClient使用的DbContext连接到不同的数据库实例。

3. 仓储实例创建方式错误
   测试中手动new RoleRepository(_dbContext, ...)，若_dbContext的生命周期或数据库连接与管道内的DbContext不一致，也会导致数据隔离。

解决步骤 #

步骤1：确保仓储正确提交数据 #

检查RoleRepository.CreateAsync方法，必须包含SaveChangesAsync()调用：

public async Task<RoleModel> CreateAsync(RoleModel model)
{
    _dbContext.Roles.Add(model);
    await _dbContext.SaveChangesAsync(); // 关键：提交到数据库
    return model;
}

步骤2：修复TestFactory的数据库配置 #

修改工厂类，确保整个实例生命周期内使用同一个数据库名，并正确替换DbContext配置：

public class TestFactory<TProgram, TDbContext> : WebApplicationFactory<TProgram>
 where TProgram : class where TDbContext : DbContext
{
    // 实例级唯一数据库名，确保所有DbContext共享同一库
    private readonly string _dbName = Guid.NewGuid().ToString();

    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureTestServices(services =>
        {
            // 移除原有DbContext配置
            var dbOptionDescriptor = services.SingleOrDefault(
                d => d.ServiceType == typeof(DbContextOptions<TDbContext>)
            );
            if (dbOptionDescriptor != null)
            {
                services.Remove(dbOptionDescriptor);
            }

            // 添加InMemory数据库，使用全局唯一名称
            services.AddDbContext<TDbContext>(options =>
            {
                options.UseInMemoryDatabase(_dbName);
            });

            // 初始化数据库
            using var sp = services.BuildServiceProvider();
            using var scope = sp.CreateScope();
            var dbContext = scope.ServiceProvider.GetRequiredService<TDbContext>();
            dbContext.Database.EnsureCreated();
        });
    }
}

步骤3：规范测试类中的服务获取方式 #

不要手动new仓储，直接从工厂的服务容器获取，确保与管道使用同一DbContext：

[Fact(DisplayName = "GetAsync returns a list of role models")]
public async Task GetAsync_ReturnsTaskOfRoleModelList()
{
    var roleModelInDb = new RoleModel
    {
        Id = Guid.NewGuid(),
        Name = "Role A",
        Description = "Role A Description"
    };

    // 从工厂的Scope中获取仓储，确保数据库连接一致
    using var scope = _factory.Services.CreateScope();
    var rolesRepository = scope.ServiceProvider.GetRequiredService<IRoleRepository>();
    var roleModel = await rolesRepository.CreateAsync(roleModelInDb);

    var responseData = await _client.GetFromJsonAsync<List<RoleModel>>("/api/roles");

    responseData.ShouldNotBeNull();
    responseData.ShouldBeOfType<List<RoleModel>>();
    responseData.Count.ShouldBe(1);
    responseData[0].Id.ShouldBe(roleModel.Id);
    responseData[0].Name.ShouldBe(roleModelInDb.Name);
}

步骤4：清理测试类冗余代码 #

删除测试类构造函数中重复的_dbContext.Database.EnsureCreated()调用，因为TestFactory已经完成了数据库初始化：

public RolesControllerTest()
{
    _factory = new TestFactory<Program, ADbContext>();
    _client = _factory.CreateClient();

    // 移除这行重复的EnsureCreated
    // _dbContext.Database.EnsureCreated();
}

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