java 数据库连接池实现租户数据隔离的核心做法是结合动态数据源路由与多租户上下文管理,在获取连接的阶段根据当前请求的租户标识切换目标数据源。具体而言,需要定义一个包含多个物理数据源(每个租户对应一个库或schema)的 abstractroutingdatasource,并在每次数据库操作前通过 threadlocal 或拦截器将当前租户 id 存入上下文,由路由逻辑决定使用哪个具体的 datasource。这样做的结果是,不同租户的请求会被自动分发到各自独立的数据库实例中,从而实现物理层面的数据隔离。

如何配置多数据源的路由策略
配置多数据源路由策略的关键在于继承 Spring 提供的 AbstractRoutingDataSource 类并重写 determineCurrentLookupKey() 方法。该方法返回的键值必须与注册的数据源 Map 中的 Key 保持一致。通常的做法是创建一个自定义的 TenantContext 工具类来存储当前线程的租户 ID,然后在路由器的 determineCurrentLookupKey 中读取这个 ID 并返回。如果未设置租户 ID,可以默认返回主租户或抛出异常以防止数据泄露。这种配置方式确保了连接池在初始化时就能感知到多个潜在的目标数据库,并在运行时动态选择。

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
import java.util.HashMap;
import java.util.Map;
public class DynamicDataSource extends AbstractRoutingDataSource {
@Override
protected Object determineCurrentLookupKey() {
return TenantContext.getCurrentTenantId();
}
}
// 配置类示例
@Configuration
public class DataSourceConfig {
@Bean
public DataSource dynamicDataSource() {
DynamicDataSource dataSource = new DynamicDataSource();
Map<Object, Object> targetDataSources = new HashMap<>();
targetDataSources.put("tenant_1", createDataSourceForTenant1());
targetDataSources.put("tenant_2", createDataSourceForTenant2());
dataSource.setTargetDataSources(targetDataSources);
dataSource.setDefaultTargetDataSource(createDefaultDataSource());
return dataSource;
}
}
如何在请求链路中维护租户上下文
在请求链路中维护租户上下文主要依赖于 Servlet Filter 或 Spring MVC Interceptor。当 HTTP 请求进入时,过滤器从请求头(如 X-Tenant-ID)或 JWT Token 中提取租户标识,并将其设置到 TenantContext 中。由于 ThreadLocal 的特性,该标识会在整个当前线程的执行过程中保持可见,直到请求结束。必须在过滤器的 finally 块中清除 ThreadLocal 变量,以避免在线程池复用场景下发生上下文污染。这种机制保证了从 Controller 到 DAO 层的任何数据库调用都能正确识别所属租户。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;

import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
public class TenantFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest httpRequest = (HttpServletRequest) request;
String tenantId = httpRequest.getHeader("X-Tenant-ID");
try {
if (tenantId != null) {
TenantContext.setCurrentTenantId(tenantId);
} else {
// 处理无租户ID的情况,例如默认租户或拒绝访问
TenantContext.setCurrentTenantId("default");
}
chain.doFilter(request, response);
} finally {
TenantContext.clear();
}
}
}
当租户ID不存在于已注册数据源时会发生什么
当租户 ID 存在于请求上下文中但不在 DynamicDataSource 注册的 targetDataSources Map 中时,Spring 会回退到使用 setDefaultTargetDataSource 设置的默认数据源,或者如果未设置默认数据源且 setFallbackDataSource 也未配置,则可能抛出 IllegalStateException 或返回空值导致后续 SQL 执行失败。在实际生产环境中,通常会配置一个默认的“未知租户”数据源用于记录日志或返回友好错误提示,而不是直接崩溃。这意味着开发者必须显式处理“租户不存在”这一边界条件,确保系统不会因为新租户接入而立即中断服务,而是通过扩展数据源注册表来动态支持新租户。

















