java 数据库连接池配置租户路由的核心在于将多租户标识(如 tenant_id)与物理数据源绑定,通常通过自定义 datasource 代理或 aop 拦截器实现。具体做法是定义一个包含所有可用数据源的映射表,根据当前线程上下文中的租户 id 动态获取对应的物理连接池实例,从而在应用层完成逻辑库到物理库的路由切换。

如何基于 ThreadLocal 实现动态数据源切换
基于 ThreadLocal 实现动态数据源切换的关键是维护一个全局的上下文变量来存储当前请求的租户 ID,并在每次获取连接前检查该变量以选择正确的数据源。具体做法是创建一个工具类管理 ThreadLocal<string></string>,在业务逻辑开始前设置租户 ID,结束后清理,同时编写一个继承自 AbstractRoutingDataSource 的类重写 determineCurrentLookupKey() 方法,该方法直接读取 ThreadLocal 的值作为路由键。

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
import javax.sql.DataSource;
import java.util.Map;
public class TenantRoutingDataSource extends AbstractRoutingDataSource {
private static final ThreadLocal<String> currentTenant = new ThreadLocal<>();
public TenantRoutingDataSource(Map<Object, Object> targetDataSources) {
super.setTargetDataSources(targetDataSources);
super.afterPropertiesSet();
}
@Override
protected Object determineCurrentLookupKey() {
return currentTenant.get();
}
public static void setTenantId(String tenantId) {
currentTenant.set(tenantId);
}
public static void clearTenantId() {
currentTenant.remove();
}
}
上述代码展示了核心路由类的实现。当调用 getConnection() 时,Spring 会调用 determineCurrentLookupKey() 获取当前租户 ID,然后在 targetDataSources 映射表中查找对应的 DataSource。如果 currentTenant 为空,则返回默认数据源。这种方式要求在每个请求的入口处(如 Filter 或 Interceptor)设置租户 ID,确保线程安全。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何在 Spring Boot 中注册并注入多数据源
在 Spring Boot 中注册并注入多数据源需要定义一个配置类,使用 @Bean 注解创建 TenantRoutingDataSource 实例,并将各个租户的物理数据源放入 Map 中作为目标数据源。具体做法是遍历配置文件或数据库中的租户列表,为每个租户初始化独立的 HikariCP 连接池,然后将这些连接池按租户 ID 作为 Key 存入 Map,最后将该 Map 传递给 TenantRoutingDataSource 构造函数。

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import javax.sql.DataSource;
import java.util.HashMap;
import java.util.Map;
@Configuration
public class DataSourceConfig {
@Bean
public DataSource routingDataSource() {
Map<Object, Object> targetDataSources = new HashMap<>();
// 模拟从配置加载租户数据源
targetDataSources.put("tenant_1", createHikariDataSource("jdbc:mysql://db1:3306/db1", "user1", "pass1"));
targetDataSources.put("tenant_2", createHikariDataSource("jdbc:mysql://db2:3306/db2", "user2", "pass2"));
// 设置默认数据源
targetDataSources.put("default", createHikariDataSource("jdbc:mysql://db_default:3306/default_db", "user", "pass"));
TenantRoutingDataSource routingDataSource = new TenantRoutingDataSource(targetDataSources);
routingDataSource.setDefaultTargetDataSource(targetDataSources.get("default"));
return routingDataSource;
}
private HikariDataSource createHikariDataSource(String url, String username, String password) {
HikariConfig config = new HikariConfig();
config.setJdbcUrl(url);
config.setUsername(username);
config.setPassword(password);
config.setMaximumPoolSize(10);
return new HikariDataSource(config);
}
}
这段配置代码演示了如何将多个物理数据源聚合为一个逻辑数据源。通过 createHikariDataSource 方法为每个租户创建独立的连接池,避免了连接共享带来的安全隐患。在 routingDataSource Bean 中,我们将所有租户的数据源放入 Map,并指定一个默认数据源用于处理未识别的租户 ID。这样,当应用启动时,Spring 容器会自动注入这个路由数据源,后续的业务代码只需关注租户 ID 的设置即可。
当租户 ID 不存在于配置中时路由行为是什么
当租户 ID 不存在于配置中时,路由行为取决于 AbstractRoutingDataSource 的默认数据源设置。如果设置了默认数据源,它将回退到该默认数据源;如果没有设置且目标映射中找不到键,则会抛出 IllegalStateException。具体做法是在 TenantRoutingDataSource 初始化时调用 setDefaultTargetDataSource() 指定一个备用数据源,或者在 determineCurrentLookupKey() 中增加空值检查和默认值返回逻辑,以确保系统在高负载或配置缺失时仍能保持可用性。


















