H2数据库使用Savepoint回滚失败问题排查

核心错误原因 #

你的代码有两个关键问题导致保存点无效：

1. 错误使用prepareCall执行事务控制语句：prepareCall是专门用来调用存储过程的API，执行SAVEPOINT、ROLLBACK TO SAVEPOINT这类事务控制语句，应该用createStatement或prepareStatement，用prepareCall会导致保存点没有被正确创建，回滚时自然找不到。
2. 事务未手动控制：默认情况下JDBC连接是自动提交模式，每执行一条SQL就会自动提交事务，保存点会在自动提交后直接失效，根本无法跨操作保留。

修正后的代码示例 #

// 关闭自动提交，开启手动事务控制
conn.setAutoCommit(false);

// 创建保存点，用createStatement执行事务语句
try (Statement stmt = conn.createStatement()) {
    stmt.execute("SAVEPOINT BEFORECREATE");
}

// 第一次更新操作
try (PreparedStatement prep1 = conn.prepareStatement(stmtUpdate)) {
    prep1.setString(1, label);
    prep1.executeUpdate();
} 

// 第二次更新操作
try (PreparedStatement prep = conn.prepareStatement(stmtInsert)) {
    prep.setString(1, label);
    prep.setLong(2, parentId);
    prep.executeUpdate();
    // 两次操作都成功，提交事务
    conn.commit();
} catch (SQLException ex) {
    // 第二次操作失败，回滚到保存点
    try (Statement stmt = conn.createStatement()) {
        stmt.execute("ROLLBACK TO SAVEPOINT BEFORECREATE");
    }
    // 提交回滚后的事务（避免事务悬挂）
    conn.commit();
    throw ex;
} finally {
    // 恢复自动提交模式
    conn.setAutoCommit(true);
}

Savepoint有效执行阶段说明 #

• 仅在当前手动事务内有效：必须先调用conn.setAutoCommit(false)关闭自动提交，所有操作都在同一个事务周期（从关闭自动提交到commit/rollback）内，保存点才能跨SQL操作保留。
• 保存点的生命周期：从创建开始，直到以下情况发生才会失效：
  • 事务整体提交或回滚；
  • 执行ROLLBACK TO SAVEPOINT回滚到该保存点；
  • 创建了同名的新保存点（旧的会被覆盖）。
• 自动提交模式下无意义：自动提交模式中每条SQL都是独立事务，保存点创建后立刻随事务提交失效，无法用于跨操作回滚。

额外注意点 #

• H2对保存点名称的大小写处理：不带引号的名称会自动转为大写存储，所以创建和回滚时要保持一致（要么都用大写，要么都用引号包裹小写名称）；
• 回滚到保存点后，需要手动提交事务，避免连接处于事务悬挂状态。

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