Quarkus多持久化单元依赖应用EntityManager注入失败问题

问题核心 #

构建Native镜像时触发UnsatisfiedResolutionException，无法解析带有@PersistenceUnit("dep")限定符的EntityManager依赖，本质是原注入方式不符合Quarkus多持久化单元的规范，且主应用对依赖项目的Bean扫描、配置存在遗漏。

解决步骤 #

1. 修正EntityManager注入方式

@PersistenceUnit注解的作用是注入EntityManagerFactory，而非EntityManager。针对多持久化单元场景，应使用@PersistenceContext指定目标单元名称：

import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;

public class DepRepository {
    @PersistenceContext(unitName = "dep")
    private EntityManager em;
    
    // 业务代码实现
}

2. 验证主应用application.yml配置完整性

确保主应用中完整配置dep持久化单元及其对应数据源，示例配置如下：

quarkus:
  datasource:
    default:
      db-kind: postgresql
      username: main_user
      password: main_pass
      jdbc-url: jdbc:postgresql://localhost:5432/main_db
    dep-datasource:
      db-kind: postgresql
      username: dep_user
      password: dep_pass
      jdbc-url: jdbc:postgresql://localhost:5432/dep_db
  hibernate-orm:
    default:
      datasource: default
      packages: com.myapps.main.entity
      database.generation: none
    dep:
      datasource: dep-datasource
      packages: com.myapps.dep.common
      database.generation: none

注意：dep单元的packages需指向依赖项目中实体类所在的包路径。

3. 确保主应用扫描到依赖项目的Bean

若主应用未自动识别DepRepository，需在application.yml中添加额外扫描配置：

quarkus:
  arc:
    scan:
      additional-packages: com.myapps.dep.common

4. 检查Native构建的依赖与参数

• 确认依赖项目dep-repos已引入quarkus-hibernate-orm或quarkus-hibernate-orm-panache依赖，且主应用能通过Maven/Gradle正常传递这些依赖。
• 若Native构建仍存在类缺失问题，可在主应用pom.xml中添加构建参数强制包含目标类：

<build>
  <plugins>
    <plugin>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-maven-plugin</artifactId>
      <version>2.12.2.Final</version>
      <executions>
        <execution>
          <goals>
            <goal>build</goal>
          </goals>
        </execution>
      </executions>
      <configuration>
        <nativeArgs>-H:IncludePackages=com.myapps.dep.common</nativeArgs>
      </configuration>
    </plugin>
  </plugins>
</build>

5. 重新执行构建命令

配置修改完成后，重新运行Native构建命令：

./mvnw package -Dquarkus.config.locations=file:./application.yml -Pnative

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