.NET集成测试中多TestContainers PostgreSQL实例触发PostgreSQL唯一约束冲突问题

看起来你遇到的这个偶现的23505: duplicate key value violates unique constraint "pg_type_typname_nsp_index"错误，核心原因是进程级环境变量的共享性导致多个TestContainers实例的数据库连接串互相覆盖，最终两个测试集合的DbContext意外连接到了同一个数据库，同时执行迁移操作时触发了PostgreSQL系统表的唯一约束冲突。

问题根源分析 #

你当前的实现是通过System.Environment.SetEnvironmentVariable("ConnectionStrings__DbConnection", _postgresContainer.GetConnectionString())传递连接串，但环境变量是进程全局的。XUnit默认会并行执行不同测试集合的初始化逻辑，当FullSetupWriteFactory和FullSetupReadFactory同时初始化时，后设置的环境变量会直接覆盖前一个的配置。这就会导致其中一个工厂的DbContext拿到的是另一个容器的连接串，两个实例同时在同一个数据库上跑迁移——而PostgreSQL的pg_type表（存储数据库类型）不允许同一个命名空间下出现重复的类型名，自然就触发了唯一约束冲突。而且因为并行执行的时机不固定，所以错误是偶现的。

解决方案 #

方案1：直接在容器内配置DbContext连接串（推荐）

不要用全局环境变量传递连接串，而是直接在ConfigureServices中替换DbContext的配置，确保每个工厂的DbContext使用专属的TestContainers连接串：

修改你的FullSetupWriteFactory（FullSetupReadFactory做同样修改）：

public class FullSetupWriteFactory : WebApplicationFactory<Program>, IAsyncLifetime
{
    private readonly PostgreSqlContainer _postgresContainer;

    public FullSetupWriteFactory()
    {
        var dbName = $"db_{Guid.NewGuid():N}";
        _postgresContainer = new PostgreSqlBuilder()
            .WithDatabase(dbName)
            .Build();
    }

    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.ConfigureServices(services =>
        {
            // 移除原有的DbContext配置，避免默认配置干扰
            var dbContextDescriptor = services.SingleOrDefault(
                d => d.ServiceType == typeof(DbContextOptions<YourDbContext>));
            if (dbContextDescriptor != null)
            {
                services.Remove(dbContextDescriptor);
            }

            // 直接注册当前容器的DbContext配置，确保隔离性
            services.AddDbContext<YourDbContext>(options =>
            {
                options.UseNpgsql(_postgresContainer.GetConnectionString());
            });
        });
    }

    public async Task InitializeAsync()
    {
        await _postgresContainer.StartAsync();
    }

    public new async Task DisposeAsync()
    {
        await _postgresContainer.StopAsync();
        await _postgresContainer.DisposeAsync();
    }
}

关键优化点：

• 抛弃全局环境变量传递方式，直接为每个工厂的DbContext绑定专属的容器连接串
• 先移除原有DbContext注册，彻底避免默认配置（如appsettings、全局环境变量）的干扰

方案2：禁用XUnit测试集合并行执行（下策）

如果暂时无法修改工厂逻辑，可以通过禁用XUnit的集合并行执行来避免环境变量冲突：
在项目根目录创建xunit.runner.json文件，添加以下内容：

{
  "parallelizeTestCollections": false
}

注意要将这个文件的"复制到输出目录"设置为"如果较新则复制"。不过这个方案会显著降低测试执行速度，仅作为临时应急方案。

额外验证点 #

• 确认IAsyncLifetime的实现正确：你当前的代码已经在集合测试启动前初始化容器、测试结束后销毁容器，这部分逻辑没问题
• 无需手动指定容器端口：TestContainers默认会随机映射主机端口，自然避免端口冲突

修改完成后，每个测试集合的DbContext都会完全隔离在自己的PostgreSQL容器实例中，迁移操作也只会在专属数据库中执行，就不会再出现系统表的唯一约束冲突了。

内容来源于stack exchange