java 数据库连接池本身不直接提供租户权限配置,而是通过应用层拦截器或 aop 机制在获取连接时动态切换数据源或设置会话上下文来实现。具体做法是定义一个基于 threadlocal 的租户上下文,在请求进入时解析租户标识并存储,随后利用 mybatis-plus 的多租户插件或自定义 datasource 代理,在 sql 执行前自动注入租户过滤条件或切换 schema。这样能确保不同租户的数据隔离,同时保持代码的解耦和可维护性。

如何集成多租户插件实现自动过滤
使用 MyBatis-Plus 的 TenantLineInnerInterceptor 可以自动为所有 SQL 添加租户 ID 过滤条件。需要在 Spring 配置类中注册该拦截器,并指定租户 ID 的获取方式。例如,从当前线程上下文中获取租户 ID,若为空则可能拒绝访问或默认使用某个租户。这种方式适用于大多数单库多行的场景,无需修改现有 SQL 语句。

import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.TenantLineInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new TenantLineHandler() {
@Override
public String getTenantIdColumn() {
return "tenant_id";
}
@Override
public Object getTenantId() {
// 从 ThreadLocal 获取当前租户ID
return TenantContext.getCurrentTenantId();
}
}));
return interceptor;
}
}
上述代码展示了如何配置拦截器。当执行 SELECT * FROM users 时,插件会自动转换为 SELECT * FROM users WHERE tenant_id = 'current_tenant_id'。这要求数据库中每个表都包含 tenant_id 列。如果某些表不需要隔离,可以通过注解 @TenantIgnore 排除。这种方案简单高效,适合 SaaS 应用中常见的数据隔离需求。
如何实现多数据源动态切换
对于需要跨库或多 Schema 隔离的场景,可以使用 DynamicDataSource 根据租户 ID 动态切换数据源。核心思路是创建一个继承 AbstractRoutingDataSource 的类,重写 determineCurrentLookupKey 方法,该方法返回当前租户对应的数据源键。结合 AOP 或拦截器,在每次请求开始时设置租户上下文,从而决定使用哪个数据源。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
import javax.sql.DataSource;
import java.util.Map;
public class TenantRoutingDataSource extends AbstractRoutingDataSource {
@Override
protected Object determineCurrentLookupKey() {
return TenantContext.getCurrentTenantId();
}
public void setTargetDataSources(Map<object object> targetDataSources) {
super.setTargetDataSources(targetDataSources);
}
public void setDefaultTargetDataSource(Object defaultTargetDataSource) {
super.setDefaultTargetDataSource(defaultTargetDataSource);
}
}</object>
在实际使用中,需要在 Spring 配置中注册这个路由数据源,并为每个租户预定义好对应的物理数据源。例如,租户 T1 对应 ds_t1,租户 T2 对应 ds_t2。当请求到达时,系统根据当前线程中的租户 ID 查找对应的数据源键,然后从目标数据源池中获取连接。这种方式实现了物理层面的数据隔离,安全性更高,但配置复杂度也相应增加。建议仅在业务强依赖多库隔离时使用。
ThreadLocal 在并发环境下如何保证安全
ThreadLocal 用于存储当前请求的租户 ID,其设计初衷就是为每个线程提供独立的变量副本,因此在多线程环境下天然具备线程安全性。只要确保在每个请求处理开始前设置租户 ID,并在请求结束后清除,就不会出现数据混淆。需要注意的是,如果使用线程池,必须显式调用 remove() 方法清理上下文,避免线程复用导致脏数据残留。
public class TenantContext {
private static final ThreadLocal<string> CURRENT_TENANT = new ThreadLocal();
public static void setCurrentTenantId(String tenantId) {
CURRENT_TENANT.set(tenantId);
}
public static String getCurrentTenantId() {
return CURRENT_TENANT.get();
}
public static void clear() {
CURRENT_TENANT.remove();
}
}</string>
在实际项目中,通常会在 Web 过滤器或 Spring Interceptor 中统一处理租户上下文的设置与清理。例如,在请求进入时从 Header 或 Token 中解析租户 ID 并调用 setCurrentTenantId,在 finally 块中调用 clear 确保资源释放。这样可以避免遗漏清理导致的内存泄漏或逻辑错误。此外,若涉及异步任务,需手动传递租户上下文到子线程,因为 ThreadLocal 不会自动传播到异步线程中。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










