如何优雅让Maven依赖JAR中的JPA实体被持久化提供者识别？

你遇到的是EclipseLink识别Maven依赖JAR中JPA组件的常见问题，以下几种更简洁的解决方案：

方案1：用包名通配符批量指定类 #

不用逐个列出实体和转换器，直接通过包名通配符覆盖整个共享包：

<persistence-unit name="YourPU" transaction-type="RESOURCE_LOCAL">
    <!-- 其他配置（数据源、持久化提供者等） -->
    <exclude-unlisted-classes>true</exclude-unlisted-classes>
    <class>my.app.persistence.*</class>
</persistence-unit>

EclipseLink会自动扫描my.app.persistence包下的所有实体类和自定义转换器，比逐个添加<class>标签高效得多。

方案2：正确配置<jar-file>的类路径写法 #

你之前的<jar-file>无效是因为EclipseLink默认从当前应用的文件系统路径查找，而非类路径。添加classpath:前缀就能让它从Maven依赖的类路径中定位目标JAR：

<persistence-unit name="YourPU" transaction-type="RESOURCE_LOCAL">
    <!-- 其他配置 -->
    <exclude-unlisted-classes>true</exclude-unlisted-classes>
    <jar-file>classpath:my-app-persistence.jar</jar-file>
</persistence-unit>

如果JAR带版本号（比如my-app-persistence-1.0.0.jar），可以用通配符适配版本变化：classpath:my-app-persistence-*.jar。

方案3：在共享JAR中维护独立ORM元数据 #

在共享JAR的META-INF目录下创建orm.xml，集中管理实体和转换器：

<entity-mappings xmlns="http://xmlns.jcp.org/xml/ns/persistence/orm"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence/orm http://xmlns.jcp.org/xml/ns/persistence/orm_2_2.xsd"
                 version="2.2">
    <package>my.app.persistence</package>
    <entity class="my.app.persistence.Entity"/>
    <converter class="my.app.persistence.MapToJsonConverter"/>
    <converter class="my.app.persistence.UuidConverter"/>
</entity-mappings>

主应用的persistence.xml只需引用这个元数据文件，无需重复列类：

<persistence-unit name="YourPU" transaction-type="RESOURCE_LOCAL">
    <!-- 其他配置 -->
    <mapping-file>META-INF/orm.xml</mapping-file>
    <exclude-unlisted-classes>true</exclude-unlisted-classes>
</persistence-unit>

这种方式适合共享JAR需要单独维护元数据的场景，主应用引入依赖后自动识别组件。

方案4：关闭显式类列表限制（谨慎使用） #

如果希望EclipseLink扫描整个类路径下的所有JPA组件，可将<exclude-unlisted-classes>设为false：

<persistence-unit name="YourPU" transaction-type="RESOURCE_LOCAL">
    <!-- 其他配置 -->
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
</persistence-unit>

注意：此方式会扫描所有类路径下的JPA组件，可能引入不必要的类、增加启动时间，仅在组件范围明确且无冗余类的场景下使用。

内容的提问来源于stack exchange，提问作者Sogawa-sps