从Wildfly 21迁移至Wildfly 27+Hibernate 6.3.0时遇启动错误求助

核心原因 #

错误提示Only support for basic-valued, entity-valued and embedded model-parts have been implemented : tipo [null]明确说明：你的SqlResultSetMapping定义中包含Hibernate 6暂未支持的映射类型，大概率是某个属性映射的类型缺失（tipo [null]）或属于集合、自定义复杂类型这类未实现支持的范畴。

排查与修复步骤 #

1. 全面检查所有结果集映射定义

   • 扫描代码中所有@SqlResultSetMapping注解，以及persistence.xml里的<sql-result-set-mapping>配置；
   • 重点核对每个@AttributeResult（或<attribute-result>）的type属性：
     • 确认type未被遗漏或设置为null；
     • 确保映射的类型是基础类型（如String、Integer）、实体类型或嵌入式类型（@Embeddable），Hibernate 6目前不支持集合或自定义复杂类型的直接映射。

2. 修正不兼容的映射

   • 若涉及集合类型映射：改用@ConstructorResult通过构造函数组装对象，或者拆分查询后在业务层手动拼接集合；
   • 若涉及自定义类型：将其转为基础类型包装，或实现Hibernate 6的UserType接口进行适配；
   • 确保所有@AttributeResult的type与对应实体属性类型一致，让Hibernate可以正确推断映射规则。

3. 解决Wildfly 27的Hibernate版本冲突

   • 日志显示系统实际使用的是org.hibernate@6.1.5.Final，但你声称已升级到6.3.0，说明Wildfly自带的Hibernate模块覆盖了你打包的版本。需在项目中添加jboss-deployment-structure.xml排除容器自带模块：

     <jboss-deployment-structure>
         <deployment>
             <exclusions>
                 <module name="org.hibernate" slot="main"/>
             </exclusions>
             <dependencies>
                 <module name="jakarta.persistence.api" export="true"/>
                 <module name="jakarta.transaction.api" export="true"/>
             </dependencies>
         </deployment>
     </jboss-deployment-structure>
     

问题背景 #

从Wildfly 21迁移至Wildfly 27，原Hibernate 5升级为6.3.0，已解决Jakarta Persistence迁移问题，但启动时出现SessionFactory构建失败，核心错误栈如下：

Caused by: org.hibernate.NotYetImplementedFor6Exception: Only support for basic-valued, entity-valued and embedded model-parts have been implemented : tipo [null]
    at org.hibernate@6.1.5.Final//org.hibernate.boot.query.SqlResultSetMappingDescriptor$AttributeFetchDescriptor.getFetchMemento(SqlResultSetMappingDescriptor.java:439)
    at org.hibernate@6.1.5.Final//org.hibernate.boot.query.SqlResultSetMappingDescriptor$AttributeFetchDescriptor.resolve(SqlResultSetMappingDescriptor.java:421)
    at org.hibernate@6.1.5.Final//org.hibernate.boot.query.SqlResultSetMappingDescriptor$EntityResultDescriptor.lambda$resolve$0(SqlResultSetMappingDescriptor.java:285)
    ...

已尝试的方案：

• 检查所有依赖以确保无冲突
• 研究NotYetImplementedFor6Exception错误以理解问题
• 检查persistence.xml配置确保正确

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