Helidon MP应用Persistence.xml未生效，如何连接H2数据库？

核心问题定位 #

你的依赖中包含了helidon-integrations-cdi-eclipselink（EclipseLink集成包），但你要使用Hibernate作为JPA实现，这会导致Helidon容器优先加载EclipseLink，直接忽略你配置的Hibernate persistence-unit。

具体修复步骤 #

1. 移除冲突依赖
   删除与Hibernate冲突的EclipseLink集成依赖：

   <!-- 移除该依赖 -->
   <dependency>
       <groupId>io.helidon.integrations.cdi</groupId>
       <artifactId>helidon-integrations-cdi-eclipselink</artifactId>
       <scope>runtime</scope>
   </dependency>
   

2. 添加Hibernate核心依赖
   引入Hibernate的JPA实现包，确保容器能识别Hibernate作为JPA Provider：

   <dependency>
       <groupId>org.hibernate</groupId>
       <artifactId>hibernate-core</artifactId>
       <version>5.6.15.Final</version> <!-- 选择与你的Helidon版本兼容的版本，Helidon 2.x/3.x对应不同Hibernate版本 -->
   </dependency>
   

3. 修正persistence-unit的Provider配置
   你当前使用的org.hibernate.ejb.HibernatePersistence是Hibernate旧版本的Provider类，新版本需替换为：

   <provider>org.hibernate.jpa.HibernatePersistenceProvider</provider>
   

4. 优化数据库连接配置

   • 调整JDBC URL为更明确的路径，避免歧义：

     <property name="hibernate.connection.url" value="jdbc:h2:./h2;DB_CLOSE_ON_EXIT=FALSE" />
     

   • 如需开启H2控制台调试，可添加：

     <property name="hibernate.h2.console.enabled" value="true" />
     

5. 确保实体类被正确扫描
   如果实体类不在persistence.xml所在的类路径根目录下，建议显式添加<class>标签指定实体类，避免Hibernate无法自动检测：

   <persistence-unit name="h2" transaction-type="RESOURCE_LOCAL">
       <!-- 保留已有配置 -->
       <class>com.yourpackage.YourEntity</class>
       <!-- 多个实体类依次添加 -->
   </persistence-unit>
   

6. 验证事务配置
   由于你使用RESOURCE_LOCAL事务类型，需在代码中手动管理事务：

   // 示例：RESOURCE_LOCAL事务管理
   EntityManager em = entityManagerFactory.createEntityManager();
   EntityTransaction tx = em.getTransaction();
   tx.begin();
   // 执行数据库操作
   tx.commit();
   em.close();
   

最终依赖清单参考 #

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>io.helidon.integrations.cdi</groupId>
    <artifactId>helidon-integrations-cdi-jta-weld</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>io.helidon.integrations.cdi</groupId>
    <artifactId>helidon-integrations-cdi-datasource-hikaricp</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>io.helidon.integrations.cdi</groupId>
    <artifactId>helidon-integrations-cdi-jpa</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.6.15.Final</version>
</dependency>

内容的提问来源于stack exchange，提问作者Günter Brilowski