Quarkus使用orm.xml配置Hibernate时EntityManager为空问题求助

一、EntityManager空指针问题的核心原因与解决步骤 #

Quarkus无需依赖传统的persistence.xml，直接通过orm.xml配合自身配置即可实现实体映射。空指针的根源在于实体未被Quarkus识别、映射文件位置错误，或EntityManager注入方式不对，具体修复步骤如下：

1. 确保orm.xml路径正确 #

将orm.xml放置在项目的src/main/resources/META-INF/目录下，文件需正确映射你的Item实体，示例结构：

<?xml version="1.0" encoding="UTF-8"?>
<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">
    <entity class="com.yourpackage.Item">
        <table name="items"/>
        <!-- 配置字段、主键等映射规则 -->
    </entity>
</entity-mappings>

2. 让Quarkus扫描到实体类 #

在application.properties中添加实体包扫描配置，指定Item所在的包路径：

quarkus.hibernate-orm.packages=com.yourpackage.entity

多包用逗号分隔：quarkus.hibernate-orm.packages=com.yourpackage.entity,com.another.entity

3. 正确注入EntityManager #

Quarkus推荐用@Inject注入EntityManager，而非传统的@PersistenceUnit，示例代码：

import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import jakarta.persistence.EntityManager;

@ApplicationScoped
public class HibernateItemRepository {
    @Inject
    EntityManager em;

    public Item findById(Long id) {
        return em.find(Item.class, id);
    }
}

注意：完全用orm.xml映射的Item类必须是public权限，且有无参构造函数。

二、添加persistence.xml后依赖解析失败的原因与修复 #

Quarkus对persistence.xml的支持有限，官方不推荐使用。自定义PersistenceUnit名称（如"Inventory"）后，Quarkus不会自动创建对应实例，需显式配置：

1. 修正persistence.xml内容 #

确保文件中指定PersistenceUnit名称为"Inventory"，并包含实体类和映射文件：

<?xml version="1.0" encoding="UTF-8"?>
<persistence 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_2.xsd"
             version="2.2">
    <persistence-unit name="Inventory" transaction-type="JTA">
        <class>com.yourpackage.Item</class>
        <mapping-file>META-INF/orm.xml</mapping-file>
        <properties>
            <property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>
        </properties>
    </persistence-unit>
</persistence>

2. 在application.properties中指定PersistenceUnit #

添加配置让Quarkus识别自定义的PersistenceUnit：

quarkus.hibernate-orm.persistence-unit-name=Inventory

3. 正确注入EntityManager #

注入时需指定PersistenceUnit名称，两种方式可选：

// 方式1：@Inject配合@Named
@Inject
@Named("Inventory")
EntityManager em;

// 方式2：@PersistenceUnit指定unitName
@PersistenceUnit(unitName = "Inventory")
EntityManager em;

再次提醒：Quarkus官方建议避免使用persistence.xml，直接用orm.xml配合application.properties的配置方式更符合Quarkus轻量级设计。

三、额外检查项 #

• 补充数据库连接配置：application.properties仅配置db-kind不够，需添加账号、密码、JDBC URL：

  quarkus.datasource.username=your_db_user
  quarkus.datasource.password=your_db_password
  quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/your_db_name
  

• 确认依赖完整性：Maven的pom.xml需包含Hibernate ORM和PostgreSQL JDBC驱动：

  <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-hibernate-orm</artifactId>
  </dependency>
  <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-jdbc-postgresql</artifactId>
  </dependency>
  

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