文件型HSQLDB调用序列next value重启后重置为1问题排查

这其实是HSQLDB对序列持久化的特殊优化逻辑，不是你的操作有误～

为什么会出现这个问题？ #

HSQLDB默认情况下，只有当序列的**生成值被用于DML语句（比如INSERT/UPDATE）**时，才会把序列的当前状态持久化到db.script文件中。如果只是单独调用call next value for mysequence（也就是在DML之外获取序列值），这个操作产生的序列值属于会话级的临时消耗，不会触发持久化更新。

所以你重启数据库后，HSQLDB会从上次真正持久化的序列值开始——如果之前从未在DML中使用过这个序列，那默认就是从1重启，这就解释了db.script里的ALTER SEQUENCE PUBLIC.MYSEQUENCE RESTART WITH 1语句。

而你提到的Derby和H2，它们的序列持久化逻辑更“直观”：无论序列值是否用于DML，都会记录每次调用后的状态，所以表现符合你的预期。

解决办法 #

根据你的使用场景，有两种可行的方案：

1. 修改序列的缓存策略，强制每次调用都持久化

HSQLDB的序列默认会预分配50个值（CACHE 50），只有当缓存用完时才会更新持久化状态。你可以把缓存大小设为1，这样每次调用NEXT VALUE都会触发序列状态的持久化：

-- 修改现有序列
ALTER SEQUENCE PUBLIC.MYSEQUENCE CACHE 1;

-- 或者创建序列时直接指定
CREATE SEQUENCE PUBLIC.MYSEQUENCE START WITH 1 INCREMENT BY 1 CACHE 1;

这样即使你单独调用call next value for mysequence，重启后序列也会从上次的最后一个值继续。

2. 将获取序列值与DML操作放在同一个事务中

如果你获取序列值是为了后续写入数据库，那么把这两个操作放在同一个事务里，HSQLDB会自动把序列的状态和DML操作一起持久化：

Integer seqValue = jdbcTemplate.execute((Connection conn) -> {
    // 关闭自动提交，开启事务
    conn.setAutoCommit(false);
    try {
        // 获取序列值
        try (PreparedStatement seqStmt = conn.prepareStatement("call next value for mysequence")) {
            ResultSet rs = seqStmt.executeQuery();
            rs.next();
            seqValue = rs.getInt(1);
        }
        // 执行DML操作，使用获取到的序列值
        try (PreparedStatement insertStmt = conn.prepareStatement("INSERT INTO your_table(id, content) VALUES (?, ?)")) {
            insertStmt.setInt(1, seqValue);
            insertStmt.setString(2, "test content");
            insertStmt.executeUpdate();
        }
        // 提交事务，触发持久化
        conn.commit();
        return seqValue;
    } catch (SQLException e) {
        conn.rollback();
        throw new RuntimeException(e);
    }
});

这种方式既符合HSQLDB的设计逻辑，也能保证序列状态的正确性。

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