本文解析 jpa 单元测试中使用 h2 内存数据库（jdbc:h2:mem:）时数据“丢失”的根本原因，并提供线程安全、符合 junit 5 生命周期的共享数据方案，避免误用 @beforeall 导致的并发问题。
本文解析 jpa 单元测试中使用 h2 内存数据库（jdbc:h2:mem:）时数据“丢失”的根本原因，并提供线程安全、符合 junit 5 生命周期的共享数据方案，避免误用 @beforeall 导致的并发问题。
在 JPA 单元测试中，开发者常期望多个测试方法能共享同一份内存数据库状态（例如：teslaOne 插入数据，teslaTwo 查询验证），但实际运行时却发现 teslaTwo 查不到任何记录——这并非代码逻辑错误，而是对 H2 内存数据库机制的典型误解。
? 根本原因：jdbc:h2:mem: 的“数据库名”语义
H2 的内存数据库 URL jdbc:h2:mem: 不带名称 时，每次连接都会创建一个全新、隔离、独立的内存数据库实例。这意味着：
- teslaOne() 中 entityManagerFactory.createEntityManager() 触发连接 → 创建 DB 实例 A → 插入 Tesla；
- teslaTwo() 中再次调用 createEntityManager() → 创建全新 DB 实例 B（A 已被 GC 回收）→ 查询为空。
✅ 正确做法是为内存数据库显式指定名称，使多次连接指向同一实例：
<!-- persistence.xml 中 in.memory.test 的 URL 应改为： --> <property name="hibernate.connection.url" value="jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1"/>
关键参数说明：
- mem:testdb：testdb 是数据库名，所有使用该名称的连接共享同一内存实例；
- DB_CLOSE_DELAY=-1：防止最后一个连接关闭时自动销毁数据库（默认行为），确保跨测试生命周期存活。
⚠️ 注意：仅靠 @BeforeAll 共享 EntityManager 并不能解决问题！EntityManager 是非线程安全、短生命周期对象，不应跨测试复用；且 JUnit 5 默认并行执行测试（@Test 方法彼此独立），强行共享 EntityManager 会导致状态污染和 IllegalStateException。
✅ 推荐方案：按测试类粒度初始化 + 清理
最健壮、符合测试契约的方式是：每个测试类独占一个命名内存库，并在类级初始化数据。示例如下：
class TeslaTest {
private static final String PERSISTENCE_UNIT = "in.memory.test";
private static EntityManagerFactory emf;
@BeforeAll
static void init() {
emf = Persistence.createEntityManagerFactory(PERSISTENCE_UNIT);
// 可选：预置基础数据（如插入 Tesla）
try (EntityManager em = emf.createEntityManager()) {
em.getTransaction().begin();
Tesla tesla = new Tesla();
tesla.setVehicle("Model X");
em.persist(tesla);
em.getTransaction().commit();
}
}
@AfterAll
static void destroy() {
if (emf != null && emf.isOpen()) {
emf.close();
}
}
@Test
void teslaOne() {
try (EntityManager em = emf.createEntityManager()) {
em.getTransaction().begin();
Tesla t = new Tesla();
t.setVehicle("Model S");
em.persist(t);
em.getTransaction().commit();
Tesla found = em.find(Tesla.class, t.getID());
assertEquals("Model S", found.getVehicle());
}
}
@Test
void teslaTwo() {
try (EntityManager em = emf.createEntityManager()) {
List<Tesla> all = em.createQuery("SELECT t FROM Tesla t", Tesla.class)
.getResultList();
assertEquals(2, all.size()); // 包含 @BeforeAll 插入的 Model X + teslaOne 的 Model S
}
}
}? 关键注意事项
- 永远不要在测试方法间共享 EntityManager 实例：它绑定事务上下文和一级缓存，复用将导致 TransactionRequiredException 或脏读；
- 避免 @BeforeEach 中重复建表：H2 的 hbm2ddl.auto=update 在命名内存库中可安全复用，无需每次重建；
- 显式关闭资源：使用 try-with-resources 确保 EntityManager 和 EntityTransaction 正确释放；
- 若需完全隔离测试：改用 jdbc:h2:mem:testdb_$(UUID) 动态生成库名，配合 @AfterEach 清库（通过 DROP ALL OBJECTS）。
✅ 总结
H2 内存数据库“数据消失”的本质是 URL 未命名导致实例隔离。解决路径清晰：
① 修改 persistence.xml 使用 jdbc:h2:mem:your-name;DB_CLOSE_DELAY=-1；
② 用 @BeforeAll 初始化 EntityManagerFactory 并预置必要数据；
③ 每个测试方法内独立获取 EntityManager，用 try-with-resources 管理生命周期。
如此既保证测试独立性，又实现跨方法数据可见，真正发挥内存数据库在 JPA 测试中的高效价值。
