java 多租户数据库连接池的核心在于为每个租户维护独立的物理连接集合,并通过 tenantconnectionprovider 接口实现动态路由。具体做法是继承该接口并重写 getconnection(string tenantid) 方法,在内部根据租户 id 查找或创建对应的 datasource,从而确保不同租户的数据请求被隔离到各自的连接池中。

如何定义租户数据源映射关系
首先需要建立租户标识与具体 DataSource 实例的映射表。通常使用 ConcurrentHashMap 来存储这种关系,键为租户 ID,值为配置好的数据源对象。这样可以在获取连接时快速定位到正确的物理连接池,避免每次请求都重新创建连接池带来的性能损耗。

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import java.sql.Connection;
import java.sql.SQLException;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
public class MultiTenantHikariCP implements TenantConnectionProvider {
private final Map<string hikaridatasource> dataSourceMap = new ConcurrentHashMap();
public void addTenantDataSource(String tenantId, String url, String user, String password) {
if (!dataSourceMap.containsKey(tenantId)) {
HikariConfig config = new HikariConfig();
config.setJdbcUrl(url);
config.setUsername(user);
config.setPassword(password);
config.setMaximumPoolSize(5);
dataSourceMap.put(tenantId, new HikariDataSource(config));
}
}
@Override
public Connection getConnection(String tenantId) throws SQLException {
HikariDataSource ds = dataSourceMap.get(tenantId);
if (ds == null) {
throw new SQLException("Unknown tenant: " + tenantId);
}
return ds.getConnection();
}
@Override
public void close() {
for (HikariDataSource ds : dataSourceMap.values()) {
ds.close();
}
}
}</string>
如何在 Hibernate 中集成自定义连接提供者
在 Hibernate 配置中,需要将 hibernate.connection.provider_class 属性指向我们实现的 TenantConnectionProvider 实现类。同时,必须禁用 Hibernate 自带的默认连接管理,并设置 hibernate.multiTenancy 为 SCHEMA 或 DATABASE 模式,以便 Hibernate 能够正确地将租户上下文传递给我们的提供者。

import org.hibernate.SessionFactory;
import org.hibernate.boot.MetadataSources;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
import org.hibernate.service.ServiceRegistry;
import java.util.HashMap;
import java.util.Map;
public class HibernateMultiTenantSetup {
public static SessionFactory buildSessionFactory() {
StandardServiceRegistryBuilder registryBuilder = new StandardServiceRegistryBuilder();
Map<string string> settings = new HashMap();
// 指定自定义的多租户连接提供者
settings.put("hibernate.connection.provider_class", "com.example.MultiTenantHikariCP");
// 启用多租户支持,这里以 DATABASE 模式为例
settings.put("hibernate.multi_tenancy", "DATABASE");
// 指定当前会话的租户识别器
settings.put("hibernate.tenant_identifier_resolvers", "com.example.SimpleTenantResolver");
registryBuilder.applySettings(settings);
ServiceRegistry registry = registryBuilder.build();
MetadataSources sources = new MetadataSources(registry);
sources.addAnnotatedClass(User.class); // 添加实体类
return sources.buildMetadata().buildSessionFactory();
}
}</string>
当租户 ID 不存在于映射表中时会发生什么
如果请求中提供的租户 ID 在 dataSourceMap 中找不到对应的 HikariDataSource,getConnection 方法会直接抛出 SQLException。这意味着系统不会自动创建新的连接池,而是要求管理员预先通过 addTenantDataSource 方法注册所有合法的租户。这种设计确保了安全性,防止未授权的租户访问数据库资源。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











