SpringBoot集成Hibernate悲观锁失效：日志无锁语句排查

问题场景 #

SpringBoot集成Hibernate框架，使用MySQL 8.3（InnoDB存储引擎），已在Repository方法上添加@Lock(LockModeType.PESSIMISTIC_WRITE)注解，但日志中仅能看到SELECT、UPDATE语句，无法观测到悲观锁对应的FOR UPDATE语句，需排查原因。

用户提供的配置信息 #

spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.jpa.database-platform=org.hibernate.dialect.MySQLDialect
spring.jpa.properties.hibernate.dialect.storage_engine=innodb
logging.level.org.hibernate.engine.spi.ActionQueue=DEBUG
logging.level.org.hibernate.persister.entity.AbstractEntityPersister=DEBUG
logging.level.org.hibernate.event.internal.AbstractFlushingEventListener=DEBUG
spring.jpa.properties.hibernate.generate_statistics=false
spring.jpa.properties.hibernate.current_session_context_class=org.hibernate.context.internal.ThreadLocalSessionContext
logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type=trace
logging.level.org.springframework.transaction=trace
logging.level.org.hibernate.orm.jdbc.bind=error
spring.jpa.properties.hibernate.format_sql=false

Repository代码 #

interface JournalLogRepository : Repository<JournalLog, UUID> {

    @Lock(LockModeType.PESSIMISTIC_WRITE)
    fun save(journalLog: JournalLog)

    @Lock(LockModeType.PESSIMISTIC_WRITE)
    fun getById(id: UUID): JournalLog

...
}

日志示例（翻译后） #

o.s.t.i.TransactionInterceptor           : 获取[org.springframework.data.jpa.repository.support.SimpleJpaRepository.save]的事务

org.hibernate.SQL                        : select jl1_0.id,jl1_0.date_create...

o.s.t.i.TransactionInterceptor           : 完成[org.springframework.data.jpa.repository.support.SimpleJpaRepository.save]的事务

o.h.e.i.AbstractFlushingEventListener    : 处理刷新级联
o.h.e.i.AbstractFlushingEventListener    : 脏检查集合
o.h.e.i.AbstractFlushingEventListener    : 已刷新：1次插入，1次更新，0次删除，涉及1个对象

o.s.t.i.TransactionInterceptor           : 获取[...SpringTransactionTest.doInTransaction]的事务
o.s.t.i.TransactionInterceptor           : 获取[org.springframework.data.jpa.repository.support.SimpleJpaRepository.getById]的事务
selects...
o.s.t.i.TransactionInterceptor           : 完成[org.springframework.data.jpa.repository.support.SimpleJpaRepository.getById]的事务
TransactionInterceptor           : 完成[org.springframework.data.jpa.repository.support.SimpleJpaRepository.save]的事务
then update sql

排查原因及解决方案 #

1. Hibernate方言版本不匹配 #

当前使用的org.hibernate.dialect.MySQLDialect是适配MySQL 5.x的方言，MySQL 8.x需要使用MySQL8Dialect，旧方言无法正确生成MySQL 8.x的悲观锁语法。

修改配置：

spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect
# 可移除storage_engine配置，MySQL8Dialect默认适配InnoDB
# spring.jpa.properties.hibernate.dialect.storage_engine=innodb

2. 事务边界不正确 #

悲观锁必须在持续的事务上下文中生效。从日志可见，getById方法的事务在查询完成后立即结束，锁无法被持有，Hibernate也不会生成FOR UPDATE语句。

解决方案：
在Service层方法添加@Transactional注解，将查询（加锁）和后续业务操作放在同一个事务中：

@Service
class JournalLogService(private val repo: JournalLogRepository) {
    @Transactional
    fun processLog(id: UUID) {
        // 同一事务内执行加锁查询与更新
        val log = repo.getById(id)
        // 执行业务修改逻辑
        repo.save(log)
    }
}

3. save方法加悲观锁无效 #

@Lock注解仅对查询操作生效，用于锁定查询到的数据库行；save方法对应JPA的merge/persist写入操作，不会触发锁查询，因此save上的@Lock注解可以移除，仅保留在查询方法上即可。

4. 日志配置限制了锁语句显示 #

当前logging.level.org.hibernate.orm.jdbc.bind=error会屏蔽SQL绑定细节，可调整日志配置以完整输出包含FOR UPDATE的SQL语句：

logging.level.org.hibernate.orm.jdbc.bind=DEBUG
spring.jpa.show-sql=true

5. 确认数据库引擎与隔离级别 #

• 检查目标表是否为InnoDB引擎（MyISAM不支持事务和行锁）：

  SHOW TABLE STATUS LIKE 'journal_log';
  

• 确认MySQL隔离级别（默认REPEATABLE READ支持悲观锁）：

  SELECT @@transaction_isolation;
  

6. Spring Data JPA方法特性问题 #

getById默认是延迟加载模式，可能不会立即触发SQL查询。建议换成findById并返回Optional<JournalLog>，或确保Repository继承JpaRepository以触发立即查询：

interface JournalLogRepository : JpaRepository<JournalLog, UUID> {
    @Lock(LockModeType.PESSIMISTIC_WRITE)
    override fun findById(id: UUID): Optional<JournalLog>
}

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