如何固定Testcontainer中MsSqlContainer的端口号？

一、修正端口绑定的错误写法 #

你当前的端口配置逻辑有误，SQL Server容器默认监听1433端口，必须将主机端口映射到容器的1433端口才能正常连接。修改容器构建代码如下：

readonly MsSqlContainer _msSqlContainer 
    = new MsSqlBuilder().WithName("MockSqlDb")
                        .WithPortBinding(8081, 1433) // 主机8081端口映射到容器内部的SQL Server默认端口1433
                        .Build();

这样容器启动后，连接字符串会自动使用localhost,8081，你也可以手动构造连接串：Server=localhost,8081;Database=YourDb;User Id=sa;Password=YourPassword;

二、动态同步连接字符串到API（更优方案） #

如果不想固定端口（避免端口冲突），可以在容器启动后，把自动生成的连接字符串动态注入到API的配置中，无需手动修改appsettings.dev.json：

方式1：直接替换DbContext配置 #

假设你用WebApplicationFactory启动API进行集成测试，可在启动时覆盖数据库配置：

var factory = new WebApplicationFactory<Program>()
    .WithWebHostBuilder(builder =>
    {
        builder.ConfigureServices(services =>
        {
            // 移除原有数据库上下文配置
            var dbContextDescriptor = services.SingleOrDefault(
                d => d.ServiceType == typeof(DbContextOptions<YourDbContext>));
            if (dbContextDescriptor != null)
                services.Remove(dbContextDescriptor);
            
            // 注入容器的连接字符串
            services.AddDbContext<YourDbContext>(options =>
                options.UseSqlServer(_msSqlContainer.GetConnectionString()));
        });
    });

方式2：覆盖配置源 #

直接在API配置中添加内存配置项，覆盖原连接字符串：

builder.ConfigureAppConfiguration(config =>
{
    config.AddInMemoryCollection(new Dictionary<string, string>
    {
        ["ConnectionStrings:YourDbConnection"] = _msSqlContainer.GetConnectionString()
    });
});

三、关于固定端口到appsettings.dev的可行性 #

这种方式是可行的，但存在两个明显缺点：

• 容易出现端口冲突（若其他程序占用了指定端口）
• 测试环境与开发环境配置耦合，灵活性不足

更推荐使用动态注入的方式，既无需手动修改配置文件，也能适配随机端口的场景。

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