.NET Core中Finbuckle.MultiTenant的TenantInfo返回空值问题

环境与配置概述 #

使用的依赖包：

• Finbuckle.MultiTenant.AspNetCore - v9.0.0
• Finbuckle.MultiTenant.EntityFrameworkCore - v9.0.0
• Microsoft.EntityFrameworkCore - v9.0.2

项目包含3个数据库上下文：

• TenantDbContext：存储租户配置（含连接字符串）的共享数据库上下文
• CliniqueDbContext：存储租户业务数据（患者、预约等）的上下文
• ApplicationDbContext：存储租户身份认证数据的上下文

已配置Host文件和launchsettings.json用于开发环境测试：
Host文件内容：

127.0.0.1   cli1.clinique360.com
127.0.0.1   cli2.clinique360.com

launchsettings.json中配置了多端口监听（如http://*:5146）。

问题现象 #

在program.cs的ITenantInfo注册逻辑中，IMultiTenantContext<AppTenantInfo>始终返回null：

builder.Services.AddScoped<ITenantInfo>(sp =>
{
    // 此处multiTenantContext返回null
    var multiTenantContext = sp.GetService<IMultiTenantContext<AppTenantInfo>>();
    if (multiTenantContext?.TenantInfo != null)
    {
        return multiTenantContext.TenantInfo;
    }

    // 返回默认租户信息
    return new AppTenantInfo
    {
        Id = "default",
        Identifier = "default",
        Name = "Default Tenant",
        ConnectionString = builder.Configuration.GetConnectionString("DefaultConnection")
    };
});

原因分析及解决方案 #

1. 服务注册顺序错误 #

当前代码先配置多租户服务，再注册TenantDbContext：

// 先配置多租户
builder.Services.AddMultiTenant<AppTenantInfo>()
    .WithEFCoreStore<TenantDbContext, AppTenantInfo>()
    .WithHostStrategy();

// 再注册TenantDbContext
builder.Services.AddDbContext<TenantDbContext>(options =>
    options.UseNpgsql(builder.Configuration.GetConnectionString("MultiTenantConnection")));

问题：Finbuckle的WithEFCoreStore依赖已注册的TenantDbContext，但此时TenantDbContext尚未完成注册，导致多租户上下文无法正确初始化。

修复：调整注册顺序，先注册TenantDbContext再配置多租户服务：

// 1. 先注册TenantDbContext
builder.Services.AddDbContext<TenantDbContext>(options =>
    options.UseNpgsql(builder.Configuration.GetConnectionString("MultiTenantConnection")));

// 2. 再配置多租户
builder.Services.AddMultiTenant<AppTenantInfo>()
    .WithEFCoreStore<TenantDbContext, AppTenantInfo>()
    .WithHostStrategy();

2. ITenantInfo注册冲突 #

当前代码重复注册了ITenantInfo：

// 第一次注册
builder.Services.TryAddScoped<ITenantInfo>(sp =>
    sp.GetRequiredService<IMultiTenantContext<AppTenantInfo>>().TenantInfo);

// 第二次注册，覆盖了第一次
builder.Services.AddScoped<ITenantInfo>(sp => { ... });

问题：AddScoped会覆盖之前的TryAddScoped注册，而第二次注册时，若在请求管道初始化前解析IMultiTenantContext，此时UseMultiTenant中间件尚未执行，上下文自然为null。

修复：保留一个注册逻辑即可，推荐合并后的写法：

builder.Services.AddScoped<ITenantInfo>(sp =>
{
    var multiTenantContext = sp.GetService<IMultiTenantContext<AppTenantInfo>>();
    if (multiTenantContext?.TenantInfo != null)
    {
        return multiTenantContext.TenantInfo;
    }

    return new AppTenantInfo
    {
        Id = "default",
        Identifier = "default",
        Name = "Default Tenant",
        ConnectionString = builder.Configuration.GetConnectionString("DefaultConnection")
    };
});

3. Host策略匹配失效 #

检查TenantDbContext中存储的租户Identifier是否与请求Host完全匹配。例如租户的Identifier是cli1.clinique360.com，但请求Host不匹配时，Finbuckle无法找到对应租户，TenantInfo会为null，间接导致IMultiTenantContext看起来未初始化。

验证：确保租户数据已正确插入TenantDbContext对应的数据库：

INSERT INTO Tenants (Id, Identifier, Name, ConnectionString)
VALUES ('cli1', 'cli1.clinique360.com', 'Clinique 1', '你的Cli1专属PostgreSQL连接字符串');

4. 中间件执行时机说明 #

IMultiTenantContext是在UseMultiTenant中间件执行后才会被填充的。当前CliniqueDbContext和ApplicationDbContext的注册使用了工厂模式（(serviceProvider, options) =>），会在请求阶段解析ITenantInfo，此时中间件已执行，逻辑是正确的；但如果在启动时直接解析ITenantInfo，必然会得到null值。

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