Java使用JPA+Maven+Open Liberty连接Docker DB2时EntityManager为空

核心错误来自OpenLiberty容器创建JPA持久化单元失败，进而导致EntityManager无法注入，最终触发空指针，具体原因可分为5项：

• server.xml中数据源的JDBC驱动引用ID和实际定义的驱动库ID不匹配
• 容器托管的JTA类型持久化单元未在persistence.xml中指定关联的数据源JNDI地址，容器默认查找java:comp/DefaultDataSource不存在
• persistence.xml中配置了大量Hibernate专属参数，但你的服务默认使用EclipseLink作为JPA实现，这些参数全部无效，且冗余配置的JDBC连接参数会和容器数据源冲突
• DB2驱动依赖未指定provided作用域，会同时存在于应用WEB-INF/lib和服务器共享目录，引发类加载冲突
• @PersistenceContext注解错用name属性，应该用unitName指定关联的持久化单元

1. 修正server.xml配置 #

将数据源的jdbcDriver节点的libraryRef属性改为实际定义的驱动库ID：

<!-- 修改前 -->
<jdbcDriver libraryRef="jdbcLib"/>
<!-- 修改后 -->
<jdbcDriver libraryRef="DB2JCCLib"/>

2. 重写persistence.xml配置 #

删除所有冗余的Hibernate配置、直连JDBC参数，添加JTA数据源关联，明确实体类路径：

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.2"
    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">
    <persistence-unit name="jpa-unit" transaction-type="JTA">
        <!-- 关联server.xml中配置的DB2数据源 -->
        <jta-data-source>jdbc/db2</jta-data-source>
        <!-- 声明你的实体类路径 -->
        <class>models.Users</class>
        <class>models.History</class>
        <properties>
            <!-- EclipseLink专属配置，按需调整DDL策略 -->
            <property name="eclipselink.ddl-generation" value="none"/>
            <!-- 开启SQL打印，代替原来的show_sql配置 -->
            <property name="eclipselink.logging.level.sql" value="FINE"/>
            <property name="eclipselink.logging.parameters" value="true"/>
        </properties>
    </persistence-unit>
</persistence>

3. 修正pom.xml的DB2依赖作用域 #

避免驱动包重复加载：

<dependency>
    <groupId>com.ibm.db2</groupId>
    <artifactId>jcc</artifactId>
    <version>11.5.6.0</version>
    <scope>provided</scope>
</dependency>

4. 修正UserDao的注入注解 #

// 修改前
@PersistenceContext(name = "jpa-unit")
// 修改后
@PersistenceContext(unitName = "jpa-unit")
private EntityManager em;

修改完成后执行以下命令重启服务：

mvn liberty:stop && mvn liberty:run

观察启动日志无CWWJP0015E报错后，再用Postman调用接口即可正常返回数据。

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