HSQLDB MVLOCKS模式下Hibernate读请求被阻塞问题排查

一、MVLOCKS模式下仍阻塞读请求的原因 #

HSQLDB的MVLOCKS模式中，只读事务必须被显式标记为只读，才能触发非阻塞的快照读，你的当前实现存在两个核心问题：

1. session.setDefaultReadOnly(true)是Hibernate层面的设置，仅控制自身缓存行为和实体修改权限，不会同步到JDBC Connection的只读状态——HSQLDB无法识别这是只读事务，仍会加常规读锁，被写事务的排他锁阻塞。
2. 手动开启事务后再设置只读的时机错误：事务启动后HSQLDB已开始获取常规读锁，此时再设置只读无法切换到快照读模式。

而你在SQL控制台测试正常，是因为控制台显式执行了SET TRANSACTION READ ONLY，直接告知HSQLDB事务类型，触发了MVLOCKS的非阻塞逻辑。

二、让HSQLDB识别只读事务的有效方式 #

1. 使用Spring声明式事务注解（推荐） #

把FastReads的只读方法改为用@Transactional(readOnly = true)注解，Spring会在开启JDBC事务前自动调用Connection.setReadOnly(true)，HSQLDB能直接识别并启用MVLOCKS的快照读：

@Component
public class FastReads {
    ...
    @Scheduled(fixedRate = 500)
    @Transactional(readOnly = true)
    public void readLamps() {
        log.info("try to fast read");
        try (Session session = sessionFactory.openSession();) {
            log.info("Lamp read with findById(1L):");
            Lamp lamp = session.get(Lamp.class, 1L);
            log.info(lamp.toString());
        } catch (Exception e) {
            log.error("Error in readLamps", e);
        }
    }
}

注意：此时无需手动调用session.beginTransaction()和commit()，Spring会自动管理事务生命周期。

2. 手动管理事务时显式设置JDBC连接只读 #

如果必须手动管理事务，要在开启Hibernate事务前，先获取JDBC连接并设置只读：

public void readLamps() {
    log.info("try to fast read");
    try (Session session = sessionFactory.openSession();) {
        // 先设置JDBC连接只读，再开启事务
        session.doWork(connection -> connection.setReadOnly(true));
        session.beginTransaction();
        log.info("Lamp read with findById(1L):");
        Lamp lamp = session.get(Lamp.class, 1L);
        log.info(lamp.toString());
        session.getTransaction().commit();
    } catch (Exception e) {
        log.error("Error in readLamps", e);
    }
}

这样HSQLDB在事务启动时就能识别只读属性，触发非阻塞的快照读。

3. 全局配置Hibernate默认只读（适合全只读场景） #

在Hibernate配置中添加hibernate.connection.defaultReadOnly=true，让所有会话默认使用只读连接，但灵活度不如前两种方式，仅适合全局以只读操作为主的场景。

三、验证要点 #

• 确认MVLOCKS模式配置正确：spring.datasource.url=jdbc:hsqldb:mem:testdb;hsqldb.tx=mvlocks
• 查看日志，验证只读事务的JDBC Connection确实被设置为只读状态（可通过Spring事务日志或HSQLDB的调试日志确认）

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