初期应选独立Schema而非共享表,因后者依赖开发不写错SQL而风险高;租户<50时,独立Schema成本低、隔离强、运维简,且天然防跨租户漏查。

初期选错隔离方案,后期不是加钱就是重写。租户不到50个时,直接上共享库+tenant_id字段是最常见也最危险的决定——它把安全押在开发不写错SQL上,而人总会漏。
租户数<50:优先用独立Schema,别碰共享表
独立Schema(即每个租户一个数据库schema)在MySQL里成本可控、隔离清晰、运维不复杂,且能天然规避跨租户SQL漏条件的问题。应用层只需在连接建立后执行USE tenant_1或通过connection.setSchema("tenant_1")切换,Hibernate、MyBatis都能平滑支持。
- MySQL 5.7+ 原生支持,无需升级版本
- 备份可按租户粒度导出:
mysqldump -u root -p tenant_1 > tenant_1.sql - 慢查询、锁等待、连接数等监控天然按租户隔离,不会被“吵闹邻居”拖垮
- 避免用
CREATE DATABASE动态建库——初期租户少,手动预建tenant_1、tenant_2等更稳;自动化留到租户破百再补
共享表模式必须配DAO层强制注入,不能只靠ORM注解
如果硬要选共享表(比如团队已熟悉MyBatis-Plus的@TableName),那WHERE tenant_id = ?绝不能靠开发手写。MyBatis拦截器或Spring AOP必须在Executor.query()入口统一注入租户ID,且对所有SELECT、UPDATE、DELETE生效。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 拦截器需排除
admin、system等超级用户操作,但这类账号应仅用于运维,禁止接入业务接口 - 动态SQL如
<foreach></foreach>或WHERE 1=1 <if test="xxx"></if>容易绕过拦截,必须在拦截逻辑里解析AST或SQL Token,而非简单字符串匹配 - MyBatis-Plus的
tenantLine插件只改SELECT,UPDATE和DELETE仍可能漏,务必实测覆盖
MySQL 8.0.16+ 必须加CHECK约束,但别信CURRENT_USER()
ALTER TABLE orders ADD CONSTRAINT chk_tenant_id CHECK (tenant_id = CURRENT_USER())看着很美,实际不可用:MySQL的CURRENT_USER()返回的是连接认证用户(如app@%),不是业务租户ID。强行用会直接让所有INSERT失败。
- 正确做法是配合MySQL代理用户(Proxy User):创建
tenant_1@'%' IDENTIFIED WITH mysql_native_password AS 'app_user',再让应用以tenant_1身份连接,此时CURRENT_USER()才等于tenant_1 - 更现实的选择是
CHECK (tenant_id IN (1,2,3,...))配合定期同步租户白名单,虽不能实时校验,但至少拦住非法INSERT值 - 千万别用
TRIGGER或VIEW做隔离——触发器无法防止BATCH INSERT绕过,视图不支持索引下推且无法用于写操作
初期最容易被忽略的点:租户上下文传递必须穿透异步链路
一旦引入消息队列(如RocketMQ)、定时任务(@Scheduled)、线程池(CompletableFuture),TenantContext.getCurrentTenant()大概率为空或错乱。这不是ORM问题,是Java线程上下文泄漏。
- 所有
Runnable、Callable包装前必须显式拷贝当前租户ID:new TenantAwareRunnable(runnable, TenantContext.getCurrentTenant()) - RocketMQ消费端要在
MessageListenerConcurrently里手动从msg.getKeys()或header取租户标识,不能依赖线程变量 - 哪怕只用
@Async,也要自定义AsyncConfigurer,重写getAsyncExecutor()并注入TenantAwareThreadPoolTaskExecutor

















