如何基于另一DbContext获取的数据库名动态加载多租户场景租户DbContext

你遇到的空引用异常确实是开发/设计时场景下没有HttpContext导致的：EF Core迁移、控制器脚手架生成这些操作不会走正常的HTTP请求流程，IHttpContextAccessor拿到的HttpContext就是null，直接访问就会触发空引用报错。

第一步：注册基础服务 #

首先确保你已经在Startup.cs的服务注册阶段添加了IHttpContextAccessor的注册，否则就算正常请求场景也可能拿不到HttpContext：

services.AddHttpContextAccessor();
// 如果需要做租户信息缓存，同时注册内存缓存服务
services.AddMemoryCache();

第二步：改造DbContextTenant的注册逻辑 #

给原有的DbContext注册逻辑增加空判断，非请求场景（设计时、迁移）下使用默认的数据库名规避空引用：

services.AddDbContext<DbContextTenant>((serviceProvider, dbContextBuilder) =>
{
    var connectionStringPlaceHolder = Configuration.GetConnectionString("DynamicTenant");
    var httpContextAccessor = serviceProvider.GetRequiredService<IHttpContextAccessor>();
    string dbName;

    // 正常HTTP请求场景，从请求头拿租户ID
    if (httpContextAccessor.HttpContext != null 
        && httpContextAccessor.HttpContext.Request.Headers.TryGetValue("tenantId", out var tenantId))
    {
        var rawTenantId = tenantId.First();
        var cache = serviceProvider.GetRequiredService<IMemoryCache>();
        // 实现租户信息缓存，避免每次请求都查主库
        dbName = cache.GetOrCreate($"TenantDb_{rawTenantId}", entry =>
        {
            entry.AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(1);
            // 用主库上下文校验租户合法性，获取对应数据库名
            var masterDb = serviceProvider.GetRequiredService<DBContextMaster>();
            var tenantInfo = masterDb.Tenants.FirstOrDefault(t => t.TenantCode == rawTenantId);
            if (tenantInfo == null)
            {
                throw new UnauthorizedAccessException("无效的租户标识");
            }
            return tenantInfo.DbName;
        });
    }
    else
    {
        // 设计时/迁移场景用默认数据库，你可以自行定义库名，专门用于生成迁移模板
        dbName = "DefaultTenantTemplateDb";
    }

    var connectionString = connectionStringPlaceHolder.Replace("{dbName}", dbName);
    dbContextBuilder.UseSqlServer(connectionString);
});

第三步：多租户迁移适配（可选） #

如果你需要给每个独立租户库应用迁移，有两种通用实现方案：

• 先给默认的模板库生成迁移文件，租户首次接入创建数据库时，在运行时调用dbContextTenant.Database.Migrate()自动应用所有迁移
• 自定义EF Core设计时工厂，执行迁移命令时通过命令行参数传入租户ID，生成对应租户库的迁移

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