池州市网站建设_网站建设公司_VPS_seo优化

SAAS多租户详细设计文档

请关注公众号【碳硅化合物AI】

摘要

本文档阐述SAAS多租户架构设计，解决一套系统服务多个客户时的成本、数据隔离、配置个性化、扩展性和运维复杂度问题。采用逻辑租户隔离方案，通过tenant_id字段实现数据隔离，结合RBAC权限体系、元数据驱动和OAuth2+JWT认证，确保租户数据安全隔离并支持个性化配置。相比按库隔离，该方案在成本、运维效率和扩展性之间取得平衡，适合租户数量多、数据量中等的场景。

一、SAAS化多租户解决什么问题

SAAS多租户要解决的核心问题是：一套系统服务多个客户，每个客户的数据和配置要完全隔离，互不干扰。

具体来说，主要解决这几个问题：

1. 成本问题

传统方式每个客户一套系统，服务器、数据库、运维成本都是 N 倍。多租户模式下，一套系统服务所有客户，成本大幅降低。比如原来 100 个客户需要 100 套系统，现在一套系统就够了。

2. 数据隔离问题

多个客户用同一套系统，最怕的就是数据串了。A 客户能看到 B 客户的数据，这是灾难性的。多租户必须保证数据完全隔离，A 客户只能看到自己的数据。

3. 配置个性化问题

不同客户对功能、界面、流程的需求不一样。有的客户需要自定义菜单名称，有的需要调整按钮顺序，有的需要禁用某些功能。多租户要支持这种个性化配置。

4. 扩展性问题

客户数量会增长，系统要能平滑扩展。不能因为客户多了就卡顿，也不能因为某个客户数据量大就影响其他客户。

5. 运维复杂度问题

传统方式每个客户一套系统，升级、打补丁、监控都要做 N 遍。多租户模式下，一次升级所有客户都受益，运维效率大幅提升。

二、如何实现，关键点有哪些

1. 数据隔离机制

所有业务表都加tenant_id字段，这是数据隔离的基础。查询时自动带上tenant_id条件，写入时自动设置tenant_id，确保数据不会串。

2. 租户上下文管理

系统要能识别当前请求是哪个租户的。通过中间件从 JWT Token 或请求头中提取tenant_id，放到线程上下文里，后续所有操作都基于这个上下文。

3. 权限体系（RBAC）

用户-角色-权限三层模型。用户关联角色，角色关联权限，权限关联资源（菜单/按钮/API）。这样权限管理灵活，可以按角色批量授权。

4. 元数据驱动

资源（菜单、按钮、API）基于元数据定义。元数据是模板，租户资源是实例。这样既能统一管理，又能支持个性化配置。

5. 认证与授权

采用 OAuth2 + JWT 方案。全局认证用户（auth_user）作为认证主体，租户用户（tenant_user）通过auth_user_id关联，实现一人多租。JWT Token 里包含tenant_id和权限信息，资源服务验证 Token 后直接使用，无需再查数据库。

6. 架构分层

采用 DDD 四层架构：接口层（Controller）、应用层（Service）、领域层（Domain）、基础设施层（Repository）。职责清晰，易于维护。

三、数据存储方式

多租户的数据存储主要有两种方式：按库隔离和逻辑租户隔离。我们采用逻辑租户隔离。

按库隔离（Database per Tenant）

每个租户一个数据库，完全物理隔离。

优点：

• 数据完全隔离，安全性最高
• 可以按租户独立备份、恢复
• 某个租户数据量大不影响其他租户
• 可以按租户独立扩展（分库）

缺点：

• 数据库数量多，运维复杂
• 升级、打补丁要操作 N 个库
• 跨租户统计、分析困难
• 成本高（连接池、资源占用）

适用场景：租户数量少（< 100），数据量大，对隔离要求极高。

逻辑租户隔离（Shared Database, Shared Schema）

所有租户共用一个数据库，通过tenant_id字段区分。

优点：

• 运维简单，一次升级所有租户受益
• 成本低，资源利用率高
• 跨租户统计、分析方便
• 扩展性好，可以水平分片

缺点：

• 需要严格保证tenant_id过滤，否则会数据泄露
• 某个租户数据量大可能影响其他租户（需要分片）
• 备份恢复需要按租户过滤

适用场景：租户数量多（> 100），数据量中等，对成本敏感。

我们的选择：逻辑租户隔离

我们采用逻辑租户隔离，原因如下：

1. 租户数量多：预期会有大量租户，按库隔离不现实
2. 成本考虑：一套数据库服务所有租户，成本可控
3. 运维效率：一次升级、一次监控，效率高
4. 技术保障：通过中间件、拦截器、切面等技术手段，严格保证tenant_id过滤

数据隔离实现

关键实现点：

1. 查询拦截器：MyBatis 拦截器拦截所有 SQL，自动添加WHERE tenant_id = ?条件
2. 写入切面：AOP 切面拦截所有写入操作，自动设置tenant_id字段
3. 上下文管理：ThreadLocal 存储当前租户 ID，请求结束时清理
4. 权限校验：接口层校验，确保不能跨租户访问

混合方案（可选）

如果未来某个租户数据量特别大，可以采用混合方案：

• 小租户：逻辑隔离（共享库）
• 大租户：按库隔离（独立库）

通过配置表记录每个租户的存储方式，动态路由到对应的数据源。

总结

SAAS多租户的核心是数据隔离和配置个性化。我们通过tenant_id字段实现逻辑隔离，通过元数据驱动支持个性化配置，通过 RBAC 体系管理权限，通过 OAuth2 + JWT 实现认证授权。

这种方案在成本、运维、扩展性之间取得了平衡，适合租户数量多、数据量中等的场景。关键是要严格保证tenant_id的过滤和设置，不能有遗漏，否则就是严重的安全问题。