NetBeans14下多Persistence-Unit配置引发Java编译错误求助

问题场景 #

环境：NetBeans 14，支持Java 8或17
单个persistence-unit配置时，通过Users.java和UsersJpaController.java访问单表Users完全正常。仅新增第二个persistence-unit用于连接另一数据库（未新增代码或创建表），编译时触发如下错误：

Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.1:compile
(default-compile) on project management: 
Fatal error compiling: java.lang.RuntimeException:
javax.annotation.processing.FilerException:
Attempt to recreate a file for type it.lsc.management.db.Users_
-> [Help 1]

错误原因 #

JPA注解处理器（此处为EclipseLink）会为实体类生成以_结尾的辅助类（如Users_），用于JPA元数据处理。当两个persistence-unit未明确实体范围时，都会扫描到同一个Users实体类，进而尝试重复生成同一个辅助文件，导致文件创建冲突。

解决建议 #

1. 为每个persistence-unit指定专属实体范围 #

在persistence.xml的每个<persistence-unit>节点内，通过<class>标签明确该单元负责管理的实体类，避免交叉扫描。比如第一个单元仅包含对应数据库的实体，第二个单元只关联另一数据库的实体：

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.1" xmlns="http://xmlns.jcp.org/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd">
  <persistence-unit name="db_management" transaction-type="RESOURCE_LOCAL">
    <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
    <!-- 明确指定该单元管理的实体类 -->
    <class>it.lsc.management.db.Users</class>
    <properties>
      <property name="javax.persistence.jdbc.url" value="jdbc:sqlserver://192.168.0.25\SQLEXPRESS:1433;databaseName=CRM_LSC;encrypt=false"/>
      <property name="javax.persistence.jdbc.user" value="uuu"/>
      <property name="javax.persistence.jdbc.driver" value="com.microsoft.sqlserver.jdbc.SQLServerDriver"/>
      <property name="javax.persistence.jdbc.password" value="uuu!"/>
    </properties>
  </persistence-unit>
  <persistence-unit name="db_agen" transaction-type="RESOURCE_LOCAL">
    <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
    <!-- 此处添加该数据库对应的实体类，若暂时无实体可留空 -->
    <properties>
      <property name="javax.persistence.jdbc.url" value="jdbc:sqlserver://192.168.0.195\SQLEXPRESS:1433;databaseName=db_agen"/>
      <property name="javax.persistence.jdbc.user" value="uu"/>
      <property name="javax.persistence.jdbc.driver" value="com.microsoft.sqlserver.jdbc.SQLServerDriver"/>
      <property name="javax.persistence.jdbc.password" value="uuu!"/>
    </properties>
  </persistence-unit>
</persistence>

2. 隔离注解处理器的生成文件目录 #

为每个persistence-unit配置不同的辅助类生成目录，避免文件重叠。在对应单元的<properties>中添加EclipseLink的生成路径配置：

• 对于db_management单元：

  <property name="eclipselink.jpa.modelgen.source.output" value="target/generated-sources/db_management"/>
  

• 对于db_agen单元：

  <property name="eclipselink.jpa.modelgen.source.output" value="target/generated-sources/db_agen"/>
  

3. 清理项目编译缓存 #

手动清理NetBeans项目的编译目录（如target文件夹），右键项目选择「清理并生成」，清除残留的旧生成文件，避免缓存导致的冲突。

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