Play for Scala中嵌入式HSQLDB多次重启后OutOfMemoryError排查

这是嵌入式数据库在开发热重载场景下非常常见的内存泄漏问题，结合我踩过的类似坑，来帮你拆解下：

一、先明确SHUTDOWN语句的作用与局限 #

嵌入式HSQLDB的SHUTDOWN语句确实会触发数据库关闭逻辑，但它生效的前提是所有数据库连接都已正确关闭。如果还有未释放的Connection、Statement或ResultSet对象持有对HSQLDB引擎的引用，数据库实例就无法被JVM的GC回收，内存自然无法释放。

二、你遇到内存溢出的核心原因 #

结合Play开发环境的特性，大概率是这两个因素叠加导致的：

• 连接/连接池未彻底销毁：你手动执行了SHUTDOWN，但可能没同步关闭Play的数据库连接池，也没确保所有活跃连接都被释放。旧的连接对象持有HSQLDB引擎的引用，导致引擎实例一直留在内存里。
• Play热重载的类加载器问题：开发环境热重载时，Play会用新的类加载器加载应用代码，旧的类加载器及它加载的所有对象（包括未释放的HSQLDB实例、连接池）如果没被正确回收，就会变成内存里的“垃圾孤岛”。每次重启都新增一份这样的实例，20次左右就会撑爆内存。

三、解决方法（按优先级排序） #

1. 给HSQLDB连接URL加上自动关闭参数
   把你的内存版HSQLDB连接URL改成：

   jdbc:hsqldb:mem:yourdbname;shutdown=true
   

   这个参数的作用是：当最后一个数据库连接关闭时，HSQLDB会自动执行SHUTDOWN并释放所有内存，不需要你手动执行SHUTDOWN语句，可靠性更高。

2. 在Play的停止钩子中彻底销毁数据源
   利用Play的ApplicationLifecycle注册停止回调，在应用重启/停止时主动关闭连接池并释放所有资源。示例代码（Scala）：

   import play.api.inject.ApplicationLifecycle
   import javax.inject.Inject
   import scala.concurrent.Future
   
   class DatabaseShutdownHook @Inject()(lifecycle: ApplicationLifecycle, db: play.api.db.Database) {
     lifecycle.addStopHook { () =>
       Future.successful {
         // 关闭数据库连接池
         db.shutdown()
         // 如果没加shutdown=true参数，这里可以手动执行SHUTDOWN
         db.withConnection { conn =>
           val stmt = conn.createStatement()
           stmt.execute("SHUTDOWN")
           stmt.close()
         }
       }
     }
   }
   

   记得把这个类注册为Play的模块，确保停止时能触发。

3. 排查内存泄漏点（进阶）
   如果以上方法还没解决，用JVM的内存分析工具（比如jvisualvm、Eclipse Memory Analyzer）dump堆内存，查看是否有大量org.hsqldb.Database、org.hsqldb.Session这类对象被旧的类加载器持有，定位具体的泄漏源。

总结 #

你的情况并不是HSQLDB本身的BUG，而是开发环境热重载+资源未正确释放导致的内存累积。只要确保每次重启时彻底关闭连接池+让HSQLDB自动触发关闭，就能解决内存溢出问题。

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