嵌入式H2 1.4.200抛出临时文件锁定java.lang.IllegalStateException异常

问题根源 #

你遇到的锁冲突来自H2 1.4.200版本的默认临时结果集存储逻辑：

• 即使你在主库连接中配置了MV_STORE=FALSE，查询结果超出MAX_MEMORY_ROWS阈值时，H2默认会使用MVStore创建临时数据库文件存放溢出的结果集
• 你配置的FILE_LOCK=NO、LOCK_MODE=0等参数仅作用于主动连接的主数据库，不会被内部临时数据库继承，1.4.200版本的MVStore临时文件默认强制使用独占锁
• 多后台进程并行触发、前一次进程异常退出残留锁文件、临时文件名冲突都会触发该报错

解决方案 #

按优先度排序选择即可：

• 方案1（兼容性最高，无需改业务逻辑）：在连接串中新增MV_TEMP_RESULT=FALSE参数，强制临时结果集使用非MVStore的存储模式，适配你关闭主库MVStore的配置。修改后的完整连接串为：

  ;FILE_LOCK=NO;LOCK_MODE=0;UNDO_LOG=0;MAX_MEMORY_ROWS=100000;CACHE_SIZE=64000;LOG=0;MV_STORE=FALSE;MV_TEMP_RESULT=FALSE;
  

• 方案2（避免创建临时文件）：调大MAX_MEMORY_ROWS参数阈值，比如设置为500000或更高，确保查询结果集可以全部存放在内存中，不会触发磁盘溢出逻辑，自然不会生成临时文件。注意需要匹配JVM堆内存配置，避免OOM。
• 方案3（隔离进程临时目录）：每次启动后台进程时，为当前进程指定独立的临时目录，通过JVM启动参数配置-Djava.io.tmpdir=/tmp/h2_process_${当前进程唯一标识}，不同进程的临时文件完全隔离，不会出现冲突。进程退出时可自动清理该目录，避免残留文件。
• 方案4（版本升级）：如果业务允许升级H2版本，可升级到1.4.201及以上版本，该版本修复了MVStore临时文件锁的竞争问题，不会再出现该报错。

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