Hibernate Core Jakarta适配Spring版本及Bean创建错误排查

一、Hibernate Core Jakarta 5.6.15与Spring版本兼容性 #

• Hibernate Core Jakarta 5.6.x基于Jakarta EE 9规范（使用jakarta.*命名空间），而Spring 5仅支持旧的Java EE（javax.*命名空间），两者命名空间不兼容，无法直接搭配使用。
• 版本搭配规则：
  • 若使用Hibernate 5.6.x的Jakarta版本，必须搭配Spring 6及以上（Spring 6才全面支持Jakarta EE 9+）；
  • 若要继续使用Spring 5，需改用Hibernate 5.6.x的非Jakarta版本（即不带Jakarta后缀的hibernate-core，对应javax.*命名空间）。

二、迁移到Hibernate 6+Spring 6后找不到ClassLoaderDelegate的问题排查与解决 #

org.hibernate.annotations.common.reflection.ClassLoaderDelegate属于旧版hibernate-commons-annotations依赖，Hibernate 6.x已将该模块的功能整合到核心包中，不再单独提供这个类，出现此错误通常是依赖冲突或代码仍在引用旧API导致。

解决步骤： #

1. 清理冲突依赖：检查Maven配置，若显式引入了hibernate-commons-annotations（尤其是5.x及以下版本），直接移除该依赖；执行mvn dependency:tree排查是否有第三方依赖间接引入了旧版本的hibernate-commons-annotations，若有，通过<exclusions>排除。
2. 替换旧API引用：检查DAO、实体类及配置类，若有直接引用org.hibernate.annotations.common包下的类，替换为Hibernate 6的对应API：
   • 例如旧的反射操作，改用org.hibernate.metamodel.model.domain.spi.ManagedTypeImplementor或org.hibernate.jpa.spi.JpaEntityManagerFactory等Hibernate 6原生类。
3. 适配Spring+Hibernate 6配置：检查自定义的EntityManagerFactory或SessionFactory配置，确保参数适配Hibernate 6：
   • 比如LocalSessionFactoryBean的hibernateProperties中，方言需使用Jakarta版本（如org.hibernate.dialect.MySQL8Dialect而非旧版的org.hibernate.dialect.MySQL5Dialect）；
   • 移除Hibernate 6不再支持的配置属性（如hibernate.hbm2ddl.auto已替换为jakarta.persistence.schema-generation.database.action）。
4. 强制依赖一致性：确保所有Spring和Hibernate依赖均为Jakarta版本，示例Maven依赖片段：

<!-- Spring 6核心依赖 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>6.0.11</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-orm</artifactId>
    <version>6.0.11</version>
</dependency>

<!-- Hibernate 6核心依赖 -->
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.2.7.Final</version>
</dependency>

<!-- 数据库驱动（示例） -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.33</version>
</dependency>

内容的提问来源于stack exchange，提问作者Syeda Maira Saad