HSQLDB只读模式无法获取应用新增记录，如何不停止应用读取最新数据？

我之前在项目里也碰到过一模一样的问题——嵌入式HSQLDB跑着应用，只读连接连上去死活看不到新插入的数据，折腾了好一阵才摸清楚关键配置。下面是亲测有效的解决方法：

核心问题根源 #

HSQLDB默认的嵌入式模式（非Server模式）下，第一个连接会独占数据库文件，而且应用的写入操作默认会把数据缓存在内存里，不会实时刷盘；另外如果应用的事务没及时提交，或者连接没开启共享，只读连接根本读不到最新的变更。

具体解决方案 #

1. 修改应用端的JDBC连接参数（关键！） #

首先必须让应用的连接允许其他只读连接共享数据库，同时调整数据刷盘和事务隔离的配置，把应用的JDBC URL改成类似这样：

jdbc:hsqldb:file:/path/to/your/db/file;hsqldb.shared=true;hsqldb.write_delay=false;hsqldb.tx=read_committed

每个参数的作用：

• hsqldb.shared=true：允许多个连接访问同一个数据库文件，这是只读连接能看到实时数据的基础，没有这个的话只读连接只能读取应用启动前的快照
• hsqldb.write_delay=false：禁用写入延迟，让应用的写入操作实时刷到磁盘（如果担心性能，可以改成hsqldb.write_delay=1000，即1秒刷一次，平衡性能和实时性）
• hsqldb.tx=read_committed：设置事务隔离级别为读已提交，确保应用提交后的事务数据能被其他连接立即看到

2. 确保应用及时提交事务 #

如果应用里用了手动事务（没有开启自动提交），一定要在写入操作完成后调用conn.commit()，不然未提交的事务数据只读连接是看不到的。如果业务允许，也可以直接设置自动提交：

conn.setAutoCommit(true);

3. 配置只读连接的URL #

用DatabaseManagerSwing或者DBVisualizer连接时，使用只读模式的URL：

jdbc:hsqldb:file:/path/to/your/db/file;readonly=true

连接后执行select * from table-name就能看到应用新增的最新数据了。

4. 性能敏感场景的折中方案 #

如果不想实时刷盘影响应用性能，可以不用设置hsqldb.write_delay=false，而是在应用里定期执行CHECKPOINT命令，强制把内存中的数据刷到磁盘：

// 可以用定时任务每隔几分钟执行一次，或者在关键写入操作后调用
private void flushHsqldbData() {
    try (Connection conn = DriverManager.getConnection(appJdbcUrl, dbUser, dbPwd)) {
        try (Statement stmt = conn.createStatement()) {
            stmt.execute("CALL CHECKPOINT");
        }
    } catch (SQLException e) {
        // 这里可以加日志记录异常
        e.printStackTrace();
    }
}

执行这个命令后，只读连接就能看到最新的数据了，这样既能保证应用性能，又能满足查看实时数据的需求。

注意事项 #

• 如果你用的是内存模式（jdbc:hsqldb:mem:），那只读连接是看不到其他连接的数据的，因为内存模式默认是每个连接独立的（除非用mem:dbname;hsqldb.shared=true，但内存数据重启就没了，一般不用于持久化场景）
• 调整参数后记得重启应用，让配置生效

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