升级Web应用至Java17、Hibernate6x、Spring6x时遭遇Bean创建异常求助

错误信息：

org.springframework.beans.factory.BeanCreationException: 创建类路径资源[spring/application-bean.xml]中定义的名为'sessionFactoryInformix'的Bean时出错：org.hibernate.type.ComponentType类无法转换为org.hibernate.type.BasicType类（org.hibernate.type.ComponentType和org.hibernate.type.BasicType位于加载器org.apache.catalina.loader.ParallelWebappClassLoader @4d847d32的未命名模块中）

Caused by: java.lang.ClassCastException: org.hibernate.type.ComponentType类无法转换为org.hibernate.type.BasicType类（org.hibernate.type.ComponentType和org.hibernate.type.BasicType位于加载器org.apache.catalina.loader.ParallelWebappClassLoader @4d847d32的未命名模块中）

核心原因 #

Hibernate 6.x对类型系统做了大幅重构，BasicType仅用于基础数据类型（如String、Integer），ComponentType专用于复合类型（如嵌入式实体），二者的继承关系、注册逻辑和旧版本完全不同。若配置或实体类映射仍沿用旧版规则，就会触发类型转换异常。

解决方案 #

• 检查类型注册配置
  排查application-bean.xml中LocalSessionFactoryBean的类型注册配置，比如<property name="hibernateTypes">，确保基础类型和复合类型的注册逻辑分开，不要将ComponentType实例按BasicType注册。

• 修正实体类映射

  • 检查是否将@Embeddable标记的复合类型错误用了基础类型的映射注解（如@Column）；
  • 确认自定义类型是否正确实现Hibernate 6.x的对应接口：基础类型用BasicType，复合类型用CompositeUserType，不要混用旧版接口。

• 清理依赖冲突
  用Maven的dependency:tree或Gradle的dependencies任务检查依赖树，排除所有Hibernate 5.x的传递依赖，确保项目中仅存在Hibernate 6.x的相关包。

• 更新Spring整合配置
  适配Spring 6.x与Hibernate 6.x的整合规则：

  • 移除hibernateProperties中已废弃的类型相关配置项；
    确保@EnableTransactionManagement等注解的配置与Hibernate 6.x兼容。

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