.NET6集成测试使用EF Core时出现实体跟踪错误

问题场景 #

基于WebApplicationFactory<IAppMarker>和IClassFixture实现集成测试基类AppFactory，借助TestContainers为每个测试类创建独立的PostgreSQL数据库实例。在AppFactory的InitializeAsync方法中初始化测试数据，但当多个测试类并行执行时，即使每个测试类拥有独立数据库，仍会触发EF Core的实体跟踪错误：

System.InvalidOperationException: The instance of entity type 'Country' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached.

尝试过context.ChangeTracker.Clear()和AddDbContextFactory，但未能彻底解决问题。

核心原因 #

虽然每个测试类对应独立的数据库，但EF Core的实体跟踪器是绑定到DbContext实例的。如果初始化测试数据时复用了同一个DbContext实例（比如从根服务容器直接获取，而非创建独立服务范围），或者同一个DbContext实例被多个并行操作共享，就会出现同一键值的实体被重复跟踪的冲突——即使这些实体属于不同的数据库，只要在同一个DbContext实例中被处理，就会触发错误。

解决方案 #

1. 初始化数据时使用独立服务范围 #

每次初始化测试数据时，创建独立的服务范围，确保使用全新的DbContext实例，避免跨操作共享跟踪器：

public async Task InitializeAsync()
{
    await _dbContainer.StartAsync();

    // 创建独立服务范围，隔离DbContext实例
    using var scope = Services.CreateScope();
    var context = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();

    // 确保数据库结构创建完成
    await context.Database.EnsureCreatedAsync();

    // 初始化测试数据，使用NoTracking查询避免不必要的跟踪
    if (!await context.Countries.AsNoTracking().AnyAsync())
    {
        context.Countries.AddRange(
            new Country { Id = 1, Name = "测试国家1" },
            new Country { Id = 2, Name = "测试国家2" }
        );
        await context.SaveChangesAsync();
    }
}

2. 显式指定DbContext的Scoped生命周期 #

在ConfigureTestServices中显式声明DbContext的Scoped生命周期，确保每个服务范围获取独立的DbContext实例：

builder.ConfigureTestServices(services =>
{
    services.RemoveAll(typeof(IHostedService));
    services.RemoveDbContext<ApplicationDbContext>();
    services.RemoveAll<DbContext>();

    // 显式指定Scoped生命周期，强制每个Scope创建新实例
    services.AddDbContext<ApplicationDbContext>(
        options => options.UseNpgsql(_dbContainer.ConnectionString),
        ServiceLifetime.Scoped
    );
});

3. 初始化阶段禁用实体跟踪 #

如果初始化测试数据后不需要跟踪实体，可以全局禁用DbContext的跟踪行为，从根源避免跟踪冲突：

public async Task InitializeAsync()
{
    await _dbContainer.StartAsync();

    using var scope = Services.CreateScope();
    var context = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
    
    // 禁用全局跟踪行为
    context.ChangeTracker.QueryTrackingBehavior = QueryTrackingBehavior.NoTracking;

    await context.Database.EnsureCreatedAsync();

    if (!await context.Countries.AnyAsync())
    {
        context.Countries.AddRange(/* 测试数据 */);
        await context.SaveChangesAsync();
    }
}

4. 避免静态状态污染 #

确保AppFactory中所有字段（如_dbContainer）均为实例字段，不使用静态变量存储DbContext或服务容器，防止跨测试类共享状态。

为什么之前的尝试未生效 #

• context.ChangeTracker.Clear()仅能清除当前DbContext的跟踪实体，但如果同一个DbContext实例被多个并行操作复用，新的操作仍可能在清除前触发冲突；
• AddDbContextFactory若未在初始化数据时主动创建新的DbContext实例（仍复用旧实例），则无法解决跟踪冲突问题。

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