Spring Boot 2.7.8集成Data JPA多租户报错：SessionFactory未配置多租户

针对你遇到的SessionFactory was not configured for multi-tenancy异常，核心原因是Spring Boot 2.x与3.x在Hibernate多租户配置的自动处理逻辑上存在差异，2.x无法仅通过application.properties的配置自动生效，需要补充以下操作：

1. 完善配置文件参数 #

仅配置租户解析器不足以让Hibernate启用多租户模式，必须显式指定多租户策略。在application.properties中补充：

# 根据你的实际多租户类型选择SCHEMA/DATABASE/DISCRIMINATOR
spring.jpa.properties.hibernate.multiTenancy=SCHEMA
spring.jpa.properties.hibernate.tenant_identifier_resolver=com.example.multidb.TenantIdentifierResolver
# 如果使用数据源级别的多租户，还需添加连接提供者配置
# spring.jpa.properties.hibernate.multi_tenant_connection_provider=com.example.multidb.MultiTenantConnectionProvider

2. 手动配置EntityManagerFactory（关键步骤） #

Spring Boot 2.x中，Hibernate 5.x不会自动将properties中的多租户参数绑定到SessionFactory，需要通过配置类手动注入相关Bean：

@Configuration
public class MultiTenantJpaConfig {

    private final DataSource dataSource;
    private final TenantIdentifierResolver tenantIdentifierResolver;
    // 如果使用连接提供者，注入MultiTenantConnectionProvider

    public MultiTenantJpaConfig(DataSource dataSource, TenantIdentifierResolver tenantIdentifierResolver) {
        this.dataSource = dataSource;
        this.tenantIdentifierResolver = tenantIdentifierResolver;
    }

    @Bean
    public LocalContainerEntityManagerFactoryBean entityManagerFactory(EntityManagerFactoryBuilder builder) {
        LocalContainerEntityManagerFactoryBean em = builder
                .dataSource(dataSource)
                .packages("com.example.multidb")
                .persistenceUnit("multiTenantPU")
                .build();

        // 绑定多租户核心配置
        em.getJpaPropertyMap().put(AvailableSettings.MULTI_TENANCY, MultiTenancyStrategy.SCHEMA);
        em.getJpaPropertyMap().put(AvailableSettings.TENANT_IDENTIFIER_RESOLVER, tenantIdentifierResolver);
        // 数据源模式下添加此行
        // em.getJpaPropertyMap().put(AvailableSettings.MULTI_TENANT_CONNECTION_PROVIDER, multiTenantConnectionProvider);

        return em;
    }
}

3. 验证租户解析器的Bean状态 #

确保TenantIdentifierResolver类上添加了@Component注解，被Spring容器管理。如果是手动实例化的，需要在配置类中显式注册为Bean，避免Hibernate无法获取到有效实例。

4. 核对依赖版本 #

Spring Boot 2.7.8默认搭配Hibernate 5.6.x，确认你的多租户实现代码与该版本兼容，避免因版本不匹配导致的配置失效。

补充说明 #

Spring Boot 3.x（搭配Hibernate 6.x）优化了多租户配置的自动绑定逻辑，能直接读取application.properties中的配置并生效，这也是3.x环境下代码正常运行的原因。

内容的提问来源于stack exchange，提问作者codependent