EF Core多租户数据库执行迁移仅对最后一个租户生效问题排查

云上老周

2026-9-30

问题原因

核心问题出在MultitenantDbContext的OnConfiguring方法实现逻辑错误：DbContextOptionsBuilder的配置是覆盖式的，你在循环中多次调用UseSqlServer，每次都会覆盖上一次设置的数据库连接字符串，最终DbContext实例只会保留列表最后一个租户的连接配置。
EF Core默认的update-database命令执行迁移时，只会基于当前DbContext实例最终生效的单条连接字符串操作，无法自动遍历多个数据源执行迁移，你首次执行时全量成功大概率是巧合（比如之前已经手动初始化过其他租户库，或者测试时误操作多执行了几次）。

解决方案

首先修正OnConfiguring方法的错误逻辑，DbContext实例本身就应该只对应单个租户的数据库连接，不要在配置方法内循环设置连接串，修改后参考代码：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    // 单次只配置当前请求对应租户的连接串，迁移时可单独指定租户
    var currentTenant = Tenants.FirstOrDefault(t=>t.Id == 你从ITenantProvider获取的当前请求租户ID);
    if (currentTenant != null)
    {
        optionsBuilder.UseSqlServer(currentTenant.DatabaseConnectionString);
    }
    base.OnConfiguring(optionsBuilder);
}

单独编写全租户迁移执行逻辑，不要依赖默认的update-database命令，你可以在程序启动逻辑中新增迁移执行方法，参考代码：

// 可放在Program.cs或单独的迁移工具类中
public static void RunMigrationsForAllTenants(IServiceProvider serviceProvider)
{
    var tenantProvider = serviceProvider.GetRequiredService<ITenantProvider>();
    var allTenants = tenantProvider.GetTenants();
    var logger = serviceProvider.GetRequiredService<ILogger<MultitenantDbContext>>();
    foreach (var tenant in allTenants)
    {
        // 为每个租户单独生成对应连接的DbContext实例
        var options = new DbContextOptionsBuilder<MultitenantDbContext>()
            .UseSqlServer(tenant.DatabaseConnectionString)
            .Options;
        using var dbContext = new MultitenantDbContext(options, tenantProvider, logger);
        // 执行当前租户库的待应用迁移
        dbContext.Database.Migrate();
        Console.WriteLine($"租户 {tenant.Name} 数据库迁移执行完成");
    }
}

后续迁移操作流程调整为：

先正常执行add-migration [迁移名称]生成全局通用的迁移文件，迁移文件不绑定具体租户
开发环境可以直接调用上面的RunMigrationsForAllTenants方法执行全租户迁移；生产环境建议将该逻辑打包为独立的迁移工具执行，避免业务服务启动时自动迁移带来的可用性风险。
如果需要调试单个租户的迁移，可以临时指定连接串生成DbContext实例，或者给MultitenantDbContext新增带连接串参数的构造函数，配合包管理器控制台命令单独执行迁移。

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