
Hibernate 6 已彻底移除 MultiTenancyStrategy 枚举及 hibernate.multiTenancy 配置项,多租户模式现通过连接提供者(MultiTenantConnectionProvider)和租户标识解析器(CurrentTenantIdentifierResolver)隐式确定,无需显式声明策略类型。
hibernate 6 已彻底移除 `multitenancystrategy` 枚举及 `hibernate.multitenancy` 配置项,多租户模式现通过连接提供者(`multitenantconnectionprovider`)和租户标识解析器(`currenttenantidentifierresolver`)隐式确定,无需显式声明策略类型。
在 Hibernate 6(配合 Spring Boot 3)中构建多租户应用时,开发者常因沿用 Hibernate 5 的配置习惯而遇到编译错误——例如 MultiTenancyStrategy.SCHEMA 找不到、AvailableSettings.MULTI_TENANT 不再存在等。这是因为 Hibernate 官方在 6.0 版本中对多租户架构进行了简化重构:不再要求显式指定 SCHEMA、DATABASE 或 DISCRIMINATOR 策略,而是将策略语义完全下沉至实现类的行为中。
✅ 正确做法是:移除所有与 MultiTenancyStrategy 和 AvailableSettings.MULTI_TENANT 相关的代码,仅保留且正确实现以下两个核心组件:
-
MultiTenantConnectionProvider:负责根据当前租户 ID 返回对应 schema/database 的连接(如基于schema-per-tenant模式,可动态设置SET search_path TO tenant_a或切换连接池数据源); -
CurrentTenantIdentifierResolver:负责在运行时解析当前请求所属的租户标识(如从ThreadLocal、JWT、HTTP Header 或 Spring Security Context 中提取)。
以下是 Spring Boot 3 + Hibernate 6 下典型的配置片段(Java Config):
@Bean
@Primary
public LocalContainerEntityManagerFactoryBean entityManagerFactory(
DataSource dataSource,
MultiTenantConnectionProvider multiTenantConnectionProvider,
CurrentTenantIdentifierResolver tenantResolver) {
LocalContainerEntityManagerFactoryBean emf = new LocalContainerEntityManagerFactoryBean();
emf.setDataSource(dataSource);
emf.setPackagesToScan("com.example.tenant.entity");
HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
emf.setJpaVendorAdapter(vendorAdapter);
Properties properties = new Properties();
properties.put("hibernate.dialect", "org.hibernate.dialect.PostgreSQLDialect");
properties.put("hibernate.hbm2ddl.auto", "none"); // Liquibase 已接管 DDL
properties.put("hibernate.physical_naming_strategy", "org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy");
properties.put("hibernate.implicit_naming_strategy", "org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy");
// ✅ 关键:不再设置 hibernate.multiTenancy 或 MultiTenancyStrategy
properties.put("hibernate.multi_tenant_connection_provider", multiTenantConnectionProvider);
properties.put("hibernate.tenant_identifier_resolver", tenantResolver);
emf.setJpaPropertyMap(properties);
return emf;
}⚠️ 注意事项:
-
hibernate.multi_tenant_connection_provider和hibernate.tenant_identifier_resolver是 Hibernate 6 中启用多租户的唯二必需属性,命名已统一为 snake_case(旧版AvailableSettings.*常量大多已被弃用); - 若使用 Liquibase,务必关闭 Hibernate 自动 DDL(
hibernate.hbm2ddl.auto=none),避免与 Liquibase 的变更管理冲突; - 对于 schema-per-tenant 场景,
MultiTenantConnectionProvider实现中需确保连接能正确隔离 schema(如 PostgreSQL 使用search_path,MySQL 使用USE tenant_db,或 HikariCP 动态数据源路由); - Spring Boot 3.1+ 提供了更原生的
AbstractRoutingDataSource支持,可结合@RefreshScope实现租户数据源热加载,但 Hibernate 层仍需上述两个接口的实现。
总结:Hibernate 6 的多租户不是“功能削弱”,而是设计解耦——策略不再由框架配置驱动,而由你的 ConnectionProvider 和 Resolver 的具体行为定义。拥抱这一变化,能让多租户逻辑更清晰、更易测试,也更贴近生产环境的真实复杂度。

















