JBoss AS7中JPA-Hibernate连接DB2报错：未找到持久化类

这问题我之前在JBoss模块化环境里也碰到过，核心就是Hibernate找不到你的实体类，结合你用的JBoss Modules 1.5.1.Final-redhat-1，咱们从几个关键方向排查：

1. 先盯紧persistence.xml配置 #

这是最容易出问题的地方：

• 确认你是否显式列出了实体类：比如要加上<class>com.your.package.Collateral</class>，如果是想扫描整个包的实体，记得加上<exclude-unlisted-classes>false</exclude-unlisted-classes>，不然Hibernate只会加载你显式声明的类。
• 检查文件位置：在JBoss Modules中，persistence.xml必须放在模块的META-INF目录下，确保模块加载时能读取到这个配置文件。
• 核对持久化单元名称：你在JPAUtility里创建EntityManagerFactory时用的名称，必须和persistence.xml里的<persistence-unit name="xxx">完全一致。

示例正确的persistence.xml片段：

<persistence-unit name="CollateralPU" transaction-type="JTA">
    <jta-data-source>java:/jdbc/YourDataSource</jta-data-source>
    <!-- 显式声明实体类 -->
    <class>com.your.package.Collateral</class>
    <!-- 如果要自动扫描包下所有实体，打开这个配置 -->
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
    <properties>
        <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/> <!-- 根据你的数据库调整 -->
        <property name="hibernate.show_sql" value="true"/>
    </properties>
</persistence-unit>

2. 实体类注解别漏了 #

检查Collateral.java：

• 必须加@Entity注解，不然Hibernate不会把它识别为持久化类。
• 主键字段要加@Id注解，确保实体的映射规则正确。
• 包路径别写错，要和persistence.xml里声明的<class>路径完全匹配。

3. JBoss Modules的类加载隔离问题 #

这是JBoss模块化环境特有的坑：

• 你的模块要正确依赖JPA和Hibernate相关模块：在模块的module.xml里，必须引入javax.persistence.api、org.hibernate这些核心模块，不然类加载器找不到Hibernate的API和你的实体类。
• 要暴露实体类所在的包：因为JBoss Modules是类隔离的，Hibernate所在的模块默认访问不到你的实体类，需要在module.xml里添加<exports>配置，把实体类的包暴露出去。

示例module.xml片段：

<module xmlns="urn:jboss:module:1.1" name="com.your.module">
    <resources>
        <resource-root path="your-module.jar"/>
    </resources>
    <dependencies>
        <module name="javax.persistence.api"/>
        <module name="org.hibernate"/>
        <module name="javax.transaction.api"/>
        <module name="javax.servlet.api" optional="true"/>
    </dependencies>
    <!-- 暴露实体类所在的包，让Hibernate能访问 -->
    <exports>
        <export path="com.your.package"/>
    </exports>
</module>

4. 核对hibernate.cfg.xml（如果使用的话） #

如果你同时配置了hibernate.cfg.xml，要注意：

• 里面有没有添加<mapping class="com.your.package.Collateral"/>，或者有没有和persistence.xml冲突的配置（比如重复的数据源、类映射）。
• 建议优先用persistence.xml管理JPA配置，避免两个配置文件互相干扰。

5. 数据源配置一致性 #

检查standalone.xml里的数据源JNDI名称，必须和persistence.xml里的<jta-data-source>或<non-jta-data-source>完全一致，比如java:/jdbc/YourDataSource，拼写错一个字符都可能导致后续加载异常。

最后再验证EntityManager的获取逻辑 #

确保JPAUtility.java里创建EntityManagerFactory的代码没有问题，比如：

EntityManagerFactory emf = Persistence.createEntityManagerFactory("CollateralPU");
EntityManager em = emf.createEntityManager();

这里的CollateralPU必须和persistence.xml里的持久化单元名称完全匹配。

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