Java注解配合反射可在多租户系统中自动注入租户ID实现数据隔离：定义@TenantScoped和@TenantIdParam注解标记需隔离的方法或参数，通过AOP/代理在运行时反射提取并填充租户ID，结合MyBatis/JPA拦截器透明集成，辅以TTL保障跨线程与RPC上下文传递。
Java 注解配合运行时反射，可以在多租户系统中自动注入租户 ID，实现数据隔离。核心思路是：定义自定义注解标记需要租户隔离的 DAO 方法或参数，通过 AOP 或反射+代理在方法执行前动态填充租户 ID（如 tenantId），避免每个业务逻辑手动传参。
定义租户隔离注解
创建一个运行时保留的注解，用于标识哪些方法/参数需自动注入租户上下文：
- @TenantScoped：标注在方法上，表示该操作需租户隔离；可选属性指定租户 ID 来源（如 header、thread-local、Spring Security context）
- @TenantIdParam：标注在方法参数上，表示该参数应被自动赋值为当前租户 ID
示例：
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.PARAMETER})
public @interface TenantIdParam {}
运行时反射提取并注入租户 ID
在 DAO 层调用前（例如通过 Spring AOP 的 MethodInterceptor），利用反射检查目标方法是否含 @TenantIdParam，再从上下文获取租户 ID 并填充到对应参数位置：
立即学习“Java免费学习笔记（深入）”；
- 通过
Method.getParameterAnnotations()扫描所有参数，定位带@TenantIdParam的位置 - 从
TenantContext.getCurrentTenantId()（基于 ThreadLocal 或 MDC 实现）读取当前租户 ID - 若参数类型为
String、Long或自定义TenantId类型，直接赋值；若为对象，则通过 setter 或构造器注入
注意：反射修改参数需配合代理（如 JDK 动态代理或 CGLIB），不能直接修改原始方法调用栈，因此通常重写入参数组后调用 method.invoke(target, newArgs)。
与 MyBatis / JPA 集成实现透明拦截
更实用的做法不是手动反射调用，而是结合持久层框架做统一拦截：
-
MyBatis：编写
Interceptor，在Executor.update/query前解析 SQL 参数，若发现@TenantIdParam标记的方法，自动向BoundSql.parameterObject中添加tenantId字段，并在 XML 中用#{tenantId}引用 -
JPA/Hibernate：使用
@Filter+FilterDef定义租户过滤器，在实体类上启用，并通过Session.enableFilter("tenantFilter").setParameter("tenantId", id)在拦截器中激活
这样业务代码完全无感，只需在 Repository 方法上加注解，框架自动补全租户条件。
线程安全与上下文传递保障
租户 ID 必须准确、稳定地跨异步和 RPC 边界传递：
- 使用
InheritableThreadLocal或TransmittableThreadLocal（阿里 TTL）保证子线程继承租户上下文 - 在 Feign/RestTemplate 拦截器中自动透传租户 ID 到 HTTP Header（如
X-Tenant-ID），下游服务通过 Filter 解析并设置本地上下文 - 避免静态工具类直接调用
TenantContext.get()，推荐通过 Spring 的@Autowired TenantContextHolder获取，便于测试 mock
不复杂但容易忽略。
