在Wildfly中使用多版本Hibernate遇类转换异常求助

核心原因 #

类转换异常本质是同一类被不同类加载器加载：自定义模块org.hibernate.legacy@3.5.0-Final加载了SQLServerDialect，但Wildfly默认的org.hibernate@5.3.28.Final模块加载了父类Dialect，JVM判定二者为不同类，导致转换失败。说明类隔离配置未完全生效，默认Hibernate模块仍在部分场景中被加载。

具体排查步骤 #

1. 补全jboss-deployment-structure.xml配置 #

确保配置覆盖EAR内所有子部署（WAR、EJB JAR），彻底排除默认Hibernate相关模块：

<jboss-deployment-structure>
    <ear-subdeployments-isolated>true</ear-subdeployments-isolated>
    <deployment>
        <exclusions>
            <module name="org.hibernate" />
            <module name="org.hibernate.common" />
            <module name="org.hibernate.jpa" />
        </exclusions>
        <dependencies>
            <module name="org.hibernate.legacy" export="true" />
        </dependencies>
    </deployment>
    <!-- 为每个子部署单独配置，避免遗漏 -->
    <sub-deployment name="your-war-module.war">
        <exclusions>
            <module name="org.hibernate" />
            <module name="org.hibernate.common" />
            <module name="org.hibernate.jpa" />
        </exclusions>
        <dependencies>
            <module name="org.hibernate.legacy" export="true" />
        </dependencies>
    </sub-deployment>
    <sub-deployment name="your-ejb-module.jar">
        <exclusions>
            <module name="org.hibernate" />
            <module name="org.hibernate.common" />
            <module name="org.hibernate.jpa" />
        </exclusions>
        <dependencies>
            <module name="org.hibernate.legacy" export="true" />
        </dependencies>
    </sub-deployment>
</jboss-deployment-structure>

• ear-subdeployments-isolated：开启后子部署类加载器相互隔离，避免默认模块被间接引入。
• 必须排除org.hibernate.common、org.hibernate.jpa等关联模块，这类模块可能间接加载Hibernate5核心类。

2. 验证自定义org.hibernate.legacy模块配置 #

检查modules/org/hibernate/legacy/main/module.xml是否正确：

<module xmlns="urn:jboss:module:1.5" name="org.hibernate.legacy">
    <resources>
        <resource-root path="hibernate-core-3.5.0-Final.jar"/>
        <resource-root path="hibernate-annotations-3.5.0-Final.jar"/>
        <resource-root path="hibernate-commons-annotations-3.2.0.Final.jar"/>
        <!-- 加入Hibernate 3.5.0所需的所有依赖JAR -->
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.persistence.api"/>
        <module name="javax.transaction.api"/>
        <module name="org.javassist"/>
        <!-- 仅依赖Wildfly基础API，避免引入Hibernate5相关模块 -->
    </dependencies>
</module>

• 确保Hibernate3.5的所有依赖JAR都已放入模块目录，无遗漏。
• 依赖仅声明必要系统API，杜绝引入Hibernate5相关模块。

3. 修正persistence.xml配置 #

在persistence-unit中明确指定自定义模块类加载器，避免Wildfly自动选择默认Hibernate：

<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
    <persistence-unit name="YourPU" transaction-type="JTA">
        <provider>org.hibernate.ejb.HibernatePersistence</provider>
        <jta-data-source>java:/YourDataSource</jta-data-source>
        <properties>
            <property name="hibernate.dialect" value="org.hibernate.dialect.SQLServerDialect"/>
            <!-- 其他Hibernate3配置 -->
        </properties>
        <persistence-unit-metadata>
            <persistence-unit-defaults>
                <classloader>
                    <module name="org.hibernate.legacy"/>
                </classloader>
            </persistence-unit-defaults>
        </persistence-unit-metadata>
    </persistence-unit>
</persistence>

• 使用Hibernate3的Provider类org.hibernate.ejb.HibernatePersistence，而非Hibernate5的org.hibernate.jpa.HibernatePersistenceProvider。
• 通过persistence-unit-metadata指定类加载器为自定义模块，确保JPA容器使用Hibernate3类。

4. 排查隐式依赖 #

部分第三方库或系统模块可能间接依赖Hibernate5，可通过Wildfly日志排查类加载来源：

• 在standalone.xml中开启类加载日志：

  <subsystem xmlns="urn:jboss:domain:logging:8.0">
      <logger category="org.jboss.modules">
          <level name="DEBUG"/>
      </logger>
  </subsystem>
  

• 启动Wildfly后，搜索日志中org.hibernate.dialect.Dialect的加载记录，确认触发默认Hibernate加载的模块，针对性排除。

额外注意事项 #

• 确保EAR包内所有子模块（WAR、EJB）不包含任何Hibernate相关JAR，避免与模块冲突。
• Hibernate3.5对应JPA 2.0，需在persistence.xml中指定version="2.0"，避免容器自动使用更高版本JPA规范引发冲突。

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