在FullStackHero.NET Starter Kit中实现多租户表设计的注意事项

多租户架构的核心概念

在SaaS应用程序开发中，多租户架构是一个常见的设计模式。FullStackHero.NET Starter Kit作为一个企业级应用框架，内置了对多租户的支持。多租户设计的关键在于确保每个租户的数据隔离，这通常通过在数据库表中添加TenantId字段来实现。

问题现象分析

开发者在Catalog模块中创建新表时，发现生成的迁移脚本没有包含TenantId列。这种情况通常发生在以下两种场景：

1. 实体类没有正确配置多租户特性
2. 数据库上下文没有启用多租户过滤

解决方案详解

1. 实体类配置

要使实体支持多租户，需要在实体类上添加特定特性：

[TenantAware]
public class YourEntity
{
    public Guid TenantId { get; set; }
    // 其他属性...
}

[TenantAware]特性告诉框架这个实体需要多租户支持。

2. 数据库上下文配置

在DbContext中，需要确保启用了多租户过滤器：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    modelBuilder.EnableTenantFilter();
}

3. 迁移脚本生成

当使用EF Core迁移命令时：

dotnet ef migrations add AddYourEntity

框架会自动为标记了[TenantAware]的实体生成包含TenantId列的迁移脚本。

最佳实践建议

1. 明确租户策略：在设计之初就确定采用共享数据库独立Schema还是共享表的不同策略

2. 审计字段：建议同时添加CreatedBy、CreatedOn等审计字段

3. 索引优化：为TenantId添加索引以提高查询性能

4. 默认值处理：考虑是否为TenantId设置默认值或约束

常见问题排查

如果仍然遇到TenantId列缺失的情况，可以检查：

1. 实体类是否位于正确的命名空间下
2. 是否在正确的DbContext中注册了实体
3. 项目是否引用了必要的多租户功能包
4. 迁移命令是否在正确的项目上执行

总结

FullStackHero.NET Starter Kit通过完善的多租户支持，大大简化了SaaS应用的开发工作。开发者只需遵循框架的约定，正确配置实体特性和DbContext，就能自动获得多租户数据隔离的能力。理解这些机制对于构建健壮的企业级应用至关重要。