介绍

随着软件即服务 (SaaS) 持续主导技术领域，构建能够高效地从单一代码库服务于多位客户（租户）的应用程序变得至关重要。ASP.NET Core 凭借其模块化和可扩展的架构，是实现多租户 SaaS 应用程序的强大框架。

本文将指导您了解构建多租户 ASP.NET Core 应用程序的核心原则、模式和实用方法。

如果您喜欢此文章，请收藏、点赞、评论，谢谢，祝您快乐每一天。

什么是多租户？

在多租户架构中，单个应用程序实例服务于多个租户，每个租户拥有独立的数据和配置。常见的多租户模型有三种。

1、单一数据库，共享架构：所有租户共享相同的数据库和表。租户数据按请求进行过滤。

2、单一数据库，每个租户单独的模式：一个数据库，但每个租户都有自己的模式。

3、每个租户拥有独立的数据库：每个租户拥有完全独立的数据库。最安全，但也更复杂。

多租户 ASP.NET Core 应用程序的核心组件

1. 租户识别中间件

您必须从请求中识别租户，通常是通过。

子域名（例如，tenant1.app.com）
标头（例如，X-Tenant-ID）
URL 路径（例如，/tenant1/dashboard）

public class TenantResolutionMiddleware
{
private readonly RequestDelegate _next;

public TenantResolutionMiddleware(RequestDelegate next)
{
_next = next;
}

public async Task Invoke(HttpContext context, ITenantService tenantService)
{
var tenantId = context.Request.Headers["X-Tenant-ID"].FirstOrDefault();
if (string.IsNullOrEmpty(tenantId))
{
context.Response.StatusCode = 400; // Bad Request
await context.Response.WriteAsync("Tenant ID missing.");
return;
}

await tenantService.SetCurrentTenantAsync(tenantId);
await _next(context);
}
}

2. 租户环境与服务

创建一个范围服务来存储每个请求的租户信息。

public interface ITenantService
{
TenantInfo CurrentTenant { get; }
Task SetCurrentTenantAsync(string tenantId);
}

public class TenantService : ITenantService
{
public TenantInfo CurrentTenant { get; private set; }

public Task SetCurrentTenantAsync(string tenantId)
{
// Fetch tenant info from a DB or config
CurrentTenant = new TenantInfo { Id = tenantId, Name = $"Tenant {tenantId}" };
return Task.CompletedTask;
}
}

3. 使用 EF Core 进行数据隔离

使用 Entity Framework Core 中的全局查询过滤器来隔离数据。

public class AppDbContext : DbContext
{
private readonly ITenantService _tenantService;

public AppDbContext(DbContextOptions<AppDbContext> options, ITenantService tenantService)
: base(options)
{
_tenantService = tenantService;
}

public DbSet<Order> Orders { get; set; }

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
var tenantId = _tenantService.CurrentTenant?.Id;
modelBuilder.Entity<Order>().HasQueryFilter(o => o.TenantId == tenantId);
}
}

管理每个租户的配置

将功能切换、限制或品牌等配置存储在 TenantSettings 表中，并使用内存缓存或 Redis 缓存它们。

public class TenantInfo
{
public string Id { get; set; }
public string Name { get; set; }
public string ThemeColor { get; set; }
public string DbConnectionString { get; set; } // for DB-per-tenant model
}