MoneyTree.MultiTenancy 多租户

📋 概述

MoneyTree.MultiTenancy 提供可插拔的多租户中间件，支持从多种来源（HTTP 头、子域名、JWT Claim）自动解析租户标识，并提供租户上下文管理、租户信息存储和组合策略。结合 MoneyTree.EFCore.MultiTenancy 扩展包可实现数据库级别的自动租户数据隔离。

🏗️ 项目文件结构

MoneyTree.MultiTenancy/
├── MoneyTree.MultiTenancy.csproj
├── GlobalUsings.cs
├── TenantInfo.cs                          # 租户信息模型
├── Abstractions/
│   ├── IMultiTenant.cs                    # 多租户实体标记接口
│   ├── ITenantContext.cs                  # 租户上下文接口
│   ├── ITenantContextAccessor.cs          # 租户上下文访问器
│   ├── ITenantResolutionStrategy.cs       # 租户解析策略接口
│   └── ITenantStore.cs                    # 租户信息存储接口
├── Core/
│   ├── MultiTenantEntity.cs               # 多租户实体/聚合根基类
│   ├── TenantContext.cs                   # 租户上下文默认实现
│   └── TenantContextAccessor.cs           # 租户上下文访问器实现
├── Resolution/
│   ├── HeaderResolutionStrategy.cs        # HTTP 头解析策略
│   ├── HostResolutionStrategy.cs          # 子域名解析策略
│   ├── ClaimResolutionStrategy.cs         # JWT Claim 解析策略
│   ├── DefaultTenantResolutionStrategy.cs  # 默认租户策略（兜底）
│   └── CompositeResolutionStrategy.cs     # 组合策略（多策略链式尝试）
├── Store/
│   └── InMemoryTenantStore.cs             # 内存租户信息存储
├── Middleware/
│   └── MultiTenancyMiddleware.cs          # 多租户 HTTP 中间件
└── Extensions/
    ├── MultiTenancyBuilder.cs             # 流畅配置构造器
    └── MultiTenancyExtensions.cs          # DI 注册扩展

🎯 核心能力

🚀 快速开始

基础配置

// Program.cs
using MoneyTree.MultiTenancy.Extensions;

var builder = WebApplication.CreateBuilder(args);

// 最简配置：Header 策略 + 内存存储 + 默认租户
builder.Services.AddMoneyTreeMultiTenancy();

var app = builder.Build();
app.UseMoneyTreeMultiTenancy();
app.Run();

自定义配置

builder.Services.AddMoneyTreeMultiTenancy(mt =>
{
    mt.UseHeader("X-Tenant-Id")           // 从请求头解析
      .UseHost()                          // 从子域名解析
      .UseClaim("tenant_id")              // 从 JWT Claim 解析
      .UseDefault("default-tenant")       // 解析失败时的默认租户
      .UseInMemoryStore(store =>          // 内存存储
          store.Seed(new TenantInfo
          {
              Id = "tenant-001",
              Name = "企业客户A",
              ExpiresAt = DateTime.UtcNow.AddYears(1)
          }));
});

📖 使用示例

租户解析策略

标记多租户实体

// 方式一：实现 IMultiTenant 接口
public class Order : AggregateRoot, IMultiTenant
{
    public string? TenantId { get; set; }
    public string OrderNumber { get; set; } = string.Empty;
}

// 方式二：继承 MultiTenantEntity 基类
public class Product : MultiTenantEntity
{
    public string Name { get; set; } = string.Empty;
}

在服务中使用租户上下文

public class OrderService 
{
    [Inject] public ITenantContextAccessor TenantAccessor { get; private set; } = default!;

    public async Task<List<Order>> GetOrdersAsync()
    {
        var tenantId = TenantAccessor.TenantContext?.TenantId;
        // 查询自动应用租户筛选（需配合 MoneyTree.EFCore.MultiTenancy）
        return await _db.Orders.ToListAsync();
    }
}

TenantInfo 模型

🛡️ 中间件执行流程

HTTP 请求到达
    │
    ▼
MultiTenancyMiddleware
    │
    ├── 1. 通过 ITenantResolutionStrategy 解析 TenantId
    │        ├── Header → Host → Claim → Default（按策略链依次尝试）
    │
    ├── 2. 通过 ITenantStore 获取 TenantInfo
    │
    ├── 3. 验证租户状态
    │        ├── IsActive == false → 返回 403
    │        ├── IsExpired() == true → 返回 403
    │
    ├── 4. 创建 TenantContext（Scoped）
    │
    └── 5. 继续执行请求管道

🔗 与 EF Core 多租户联动

MoneyTree.EFCore.MultiTenancy 扩展包自动集成此模块，实现：

• TenantFilterInterceptor：查询时自动添加 WHERE TenantId = @currentTenantId
• TenantSaveChangesInterceptor：新增实体时自动填充 TenantId
• IgnoreTenantFilter()：管理后台跨租户查询

详见 MoneyTree.EFCore 文档。