java无法直接通过标准注解自动追加多租户过滤条件，需结合自定义@tenantid注解与mybatis拦截器、hibernate filter或spring aop，在sql执行前动态注入tenant_id = ?条件，并依赖threadlocal实现租户上下文传递。
Java 中无法直接通过标准注解让 JDBC 语句“自动追加”多租户过滤条件——注解本身只是元数据，不执行逻辑。真正实现需要结合注解 + 拦截机制（如 MyBatis 拦截器、JPA 实体监听、或 Spring AOP），在 SQL 构建或执行前动态注入 AND tenant_id = ? 条件。
1. 定义租户 ID 注解（标记实体/字段）
先创建一个自定义注解，用于标识哪些实体类或字段参与多租户隔离：
@Target({ElementType.TYPE, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface TenantId {
String value() default "tenant_id"; // 对应数据库列名
}
然后在实体类上使用：
@TenantId
@Entity
@Table(name = "order")
public class Order {
@Id private Long id;
private String item;
@Column(name = "tenant_id")
private Long tenantId; // 实际存储租户 ID 的字段
}
2. 在 MyBatis 中用拦截器自动添加 WHERE 条件
这是最常用且可控的方式。通过实现 Interceptor，在 SQL 解析后、执行前重写 SQL 并绑定参数：
- 拦截
StatementHandler.prepare()或Executor.query() - 解析原始 SQL，识别是否为 SELECT/UPDATE/DELETE 语句
- 检查目标 Mapper 接口或实体类是否标注了
@TenantId - 若匹配，且当前线程持有租户上下文（如
TenantContext.getCurrentTenantId()），则：- SELECT：追加
AND tenant_id = ?到 WHERE 子句（无 WHERE 则加WHERE tenant_id = ?） - UPDATE/DELETE：同样补全过滤，防止误更新其他租户数据
- 将租户 ID 作为额外参数插入到
ParameterHandler中
- SELECT：追加
⚠️ 注意：需兼容复杂 SQL（含子查询、UNION、括号嵌套），建议用成熟解析库如 JSqlParser 而非正则硬改。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
3. 使用 JPA + Hibernate Filter（轻量级方案）
适用于 Spring Data JPA 场景，无需改 SQL，由 Hibernate 在生成 SQL 时自动注入：
- 在实体类上启用 filter：
@Entity
@FilterDef(name = "tenantFilter", parameters = @ParamDef(name = "tenantId", type = "long"))
@Filter(name = "tenantFilter", condition = "tenant_id = :tenantId")
public class Order { ... }
- 在 Service 中启用该 filter（通常配合 AOP 或拦截器，在 DAO 方法前启用）：
Session session = entityManager.unwrap(Session.class);
session.enableFilter("tenantFilter").setParameter("tenantId", TenantContext.getCurrentTenantId());
✅ 优点：侵入性小、支持懒加载、自动生效于所有 JPQL/Criteria 查询；❌ 缺点：仅对 Hibernate 生效，原生 SQL 和部分批量操作不触发。
4. 租户上下文与线程隔离（关键基础设施）
无论用哪种方式，都必须可靠地传递当前租户 ID：
- 使用
ThreadLocal<long></long>存储（推荐封装为TenantContext工具类） - 在 Web 层（如 Spring MVC 拦截器、Filter）从请求头（
X-Tenant-ID）、Token 或子域名提取租户 ID 并设置 - 注意异步场景（如
@Async、CompletableFuture）需手动传递ThreadLocal值，或改用TransmittableThreadLocal
没有正确上下文，所有自动过滤都会失效或错绑租户。
不复杂但容易忽略的是：租户字段必须在所有相关表中存在且命名一致；DML 操作（尤其是 DELETE 和 UPDATE）必须严格过滤，否则是严重安全漏洞；测试时务必覆盖跨租户查询失败的场景。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
