使用Derby与OpenJPA配置自动建表参数后仍无法生成数据库表

问题根因 #

• 配置了不存在的JNDI非JTA数据源：persistence.xml中的<non-jta-data-source>DataSource</non-jta-data-source>配置，会让OpenJPA优先尝试从JNDI上下文查找对应数据源资源。本地Java SE嵌入式环境没有绑定该JNDI资源时，后续配置的JDBC连接参数、schema生成规则会全部失效，无法建立正确的数据库连接，自然触发表创建流程。
• 未显式声明实体类：OpenJPA在Java SE运行环境下，默认不会自动扫描classpath路径下的@Entity注解类，未被纳入持久化单元识别范围的实体，不会参与schema生成流程。
• OpenJPA对JPA标准schema属性的兼容缺陷：部分OpenJPA版本未完整适配JPA 2.2定义的javax.persistence.schema-generation.*系列属性，仅配置标准属性无法触发自动建表逻辑，需要叠加OpenJPA专属的schema同步配置。

可直接落地的修复步骤 #

1. 修正persistence.xml无效配置 #

• 直接删除<non-jta-data-source>节点（本地RESOURCE_LOCAL事务模式无需依赖JNDI数据源）
• 显式声明需要纳入持久化单元的实体类，避免扫描失效
• 叠加OpenJPA专属的表结构同步配置
  修正后的完整配置示例：

<?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 https://www.oracle.com/webfolder/technetwork/jsc/xml/ns/persistence/persistence_2_2.xsd">
    <persistence-unit name="DataLayer"
        transaction-type="RESOURCE_LOCAL">
        <!-- 替换为你自己实体类的全限定类名 -->
        <class>com.example.EntityPerson</class>
        <properties>
            <!-- Derby嵌入式连接配置 -->
            <property name="javax.persistence.jdbc.driver"
                value="org.apache.derby.jdbc.EmbeddedDriver" />
            <property name="javax.persistence.jdbc.url"
                value="jdbc:derby:db;create=true" />
            <!-- JPA标准表创建配置 -->
            <property
                name="javax.persistence.schema-generation.database.action"
                value="create" />
            <!-- OpenJPA专属表结构同步配置，必须叠加才能触发建表 -->
            <property name="openjpa.jdbc.SynchronizeMappings"
                value="buildSchema(ForeignKeys=true, Schemas=App)" />
        </properties>
    </persistence-unit>
</persistence>

2. 修正测试代码的配置传递逻辑 #

通过代码传入的配置会完全覆盖persistence.xml中的同名配置，因此需要把OpenJPA专属的建表配置同步传入EntityManagerFactory的初始化参数，示例代码：

HashMap<String, String> jpaProps = new HashMap<>();
// 原有连接配置保留
jpaProps.put("javax.persistence.jdbc.url", "jdbc:derby:db;create=true");
jpaProps.put("javax.persistence.jdbc.driver", "org.apache.derby.jdbc.EmbeddedDriver");
jpaProps.put("javax.persistence.schema-generation.database.action", "create");
// 补充OpenJPA专属建表配置，否则代码覆盖xml配置后建表逻辑失效
jpaProps.put("openjpa.jdbc.SynchronizeMappings", "buildSchema(ForeignKeys=true)");

EntityManagerFactory factory = Persistence.createEntityManagerFactory("DataLayer", jpaProps);
EntityManager manager = factory.createEntityManager();
// 后续持久化逻辑保持不变

注意事项 #

修复前请先删除本地生成的空db数据库目录，Derby嵌入式模式下检测到已存在的数据库文件时，会跳过schema创建流程，仅连接现有空库。
Derby嵌入式数据库需要在程序退出前显式执行关闭逻辑，避免数据库文件被进程持续占用、出现文件损坏：

try {
    DriverManager.getConnection("jdbc:derby:;shutdown=true");
} catch (SQLException e) {
    // Derby正常关闭时会返回SQL状态码08006，属于预期行为，无需额外处理
}

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