java 数据库连接池实现租户隔离的核心做法是结合 threadlocal 与动态数据源路由,在每次请求开始时将当前租户标识存入线程上下文,由自定义的 abstractroutingdatasource 根据该标识选择对应的物理连接池实例。这样每个线程在处理请求期间始终绑定到特定的租户数据源,从而在应用层完成逻辑隔离。若未设置租户标识或获取失败,则回退到默认数据源以避免空指针异常。

如何配置多租户数据源路由策略
通过继承 Spring 的 AbstractRoutingDataSource 并重写 determineCurrentLookupKey() 方法,可以定义从 ThreadLocal 中读取租户 ID 并映射到具体数据源 Key 的逻辑。配置时需确保所有租户的数据源 Bean 已注册,并在路由类中建立 Key 到 DataSource 的映射关系。当请求进入时,Spring 会调用该方法决定使用哪个数据源,从而实现基于租户的动态切换。

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
public class TenantRoutingDataSource extends AbstractRoutingDataSource {
@Override
protected Object determineCurrentLookupKey() {
return TenantContext.getCurrentTenantId();
}
}
如何在请求生命周期中管理租户上下文
利用 Spring MVC 的拦截器或过滤器,在请求到达 Controller 之前解析租户信息(如 HTTP Header 中的 X-Tenant-ID),并将其存入 TenantContext。在请求结束后,必须通过 finally 块清除 ThreadLocal 中的数据,防止线程复用导致的数据泄露。这种机制保证了每个请求的独立性,同时避免了手动传递参数的繁琐。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class TenantInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
String tenantId = request.getHeader("X-Tenant-ID");
if (tenantId != null) {
TenantContext.setTenantId(tenantId);
}
return true;
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
TenantContext.clear();
}
}
当 ThreadLocal 未设置租户 ID 时会发生什么
如果请求头中缺少租户标识且代码未做默认值处理,TenantContext.getCurrentTenantId() 可能返回 null。此时 AbstractRoutingDataSource 会尝试查找 Key 为 null 的数据源。若未配置默认数据源,将抛出 IllegalStateException;若配置了默认数据源,则回退使用该默认库。因此,务必在路由逻辑中增加非空判断或提供 fallback 机制以确保系统稳定性。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










