实现多租户遇EntityManagerFactory解包为SessionFactoryImplementor错误

执行多租户逻辑时抛出如下异常：

Provider does not support unwrapping javax.persistence.EntityManagerFactory to org.hibernate.engine.spi.SessionFactoryImplementor

触发异常的代码段：

protected EntityManager getEntityManager(String multitenancyIdentifier) throws SQLException {
    final SessionFactoryImplementor sf = emf.unwrap(SessionFactoryImplementor.class);
    final MultiTenantResolver tenantResolver = (MultiTenantResolver) sf.getCurrentTenantIdentifierResolver();
    tenantResolver.setTenantIdentifier(multitenancyIdentifier);
    return emf.createEntityManager();
}

异常抛出位置为emf.unwrap(SessionFactoryImplementor.class)语句。

该异常本质是当前持有的EntityManagerFactory（以下简称EMF）实例无法转换为Hibernate内部的SessionFactoryImplementor类型，常见触发场景有三类：

• 项目引入的JPA实现不是Hibernate：如果依赖中存在EclipseLink、OpenJPA等其他JPA Provider，这类实现本身没有SessionFactoryImplementor相关逻辑，自然不支持转换到Hibernate的内部类型。
• EMF被容器/框架代理：Spring、Spring Boot等容器会对原生EMF做AOP包装，生成的代理类默认不会把unwrap调用透传给底层原生Hibernate EMF，直接在代理对象上调用unwrap就会抛错。
• 依赖版本冲突：Hibernate核心包、JPA API包、Spring Data JPA包版本不兼容，会导致unwrap方法的类型校验逻辑异常，无法识别底层的SessionFactory实现。

按优先级依次排查处理：

1. 确认JPA实现为Hibernate
   排查项目Maven/Gradle依赖，排除EclipseLink、OpenJPA等非Hibernate的JPA实现包，确保hibernate-core包存在，且版本和Spring Boot/JPA版本对齐，避免版本冲突。
2. 解包代理对象获取原生EMF
   如果是Spring环境下的代理对象，不要直接在注入的EMF代理上调用unwrap，先获取原生EMF实例再做类型转换，代码示例：

   import org.springframework.orm.jpa.EntityManagerFactoryInfo;
   
   protected EntityManager getEntityManager(String multitenancyIdentifier) throws SQLException {
       EntityManagerFactory targetEmf = this.emf;
       // 解包Spring代理，拿到原生Hibernate EMF
       if (emf instanceof EntityManagerFactoryInfo) {
           targetEmf = ((EntityManagerFactoryInfo) emf).getNativeEntityManagerFactory();
       }
       final SessionFactoryImplementor sf = targetEmf.unwrap(SessionFactoryImplementor.class);
       final MultiTenantResolver tenantResolver = (MultiTenantResolver) sf.getCurrentTenantIdentifierResolver();
       tenantResolver.setTenantIdentifier(multitenancyIdentifier);
       return emf.createEntityManager();
   }
   

   更简单的方式是直接在Spring容器中注入SessionFactoryImplementor实例，跳过unwrap步骤，避免代理问题：

   @Autowired
   private SessionFactoryImplementor sessionFactory;
   
   protected EntityManager getEntityManager(String multitenancyIdentifier) throws SQLException {
       final MultiTenantResolver tenantResolver = (MultiTenantResolver) sessionFactory.getCurrentTenantIdentifierResolver();
       tenantResolver.setTenantIdentifier(multitenancyIdentifier);
       return emf.createEntityManager();
   }
   

3. 校验多租户配置正确性
   确认Hibernate多租户相关配置已正确声明，以Spring Boot yml配置为例：

   spring:
     jpa:
       properties:
         hibernate:
           multi_tenant: DATABASE # 根据实际策略选择DATABASE/SCHEMA/DISCRIMINATOR
           tenant_identifier_resolver: com.xxx.YourMultiTenantResolver # 替换为自定义解析器全类名
           multi_tenant_connection_provider: com.xxx.YourTenantConnectionProvider # 替换为自定义连接提供者全类名
   

   配置缺失会导致SessionFactory初始化逻辑异常，也可能引发unwrap类型转换失败。

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