HSQLDB + Hibernate 單元測試實戰：內存數據庫實現極速隔離測試

傳統 Hibernate 測試依賴外部資料庫，面臨環境依賴重、測試數據汙染、Schema 同步痛苦三大難題。HSQLDB 內存模式配合 Hibernate hbm2ddl.auto=create-drop，可在單元測試中秒級建立乾淨 Schema、獨立運行、零外部依賴，大幅提升 TDD 效率。

核心配置：TestSchema 靜態初始化

public class TestSchema {
    static {
        Configuration config = new Configuration()
            .setProperty("hibernate.dialect", "org.hibernate.dialect.HSQLDialect")
            .setProperty("hibernate.connection.driver_class", "org.hsqldb.jdbcDriver")
            .setProperty("hibernate.connection.url", "jdbc:hsqldb:mem:testdb")
            .setProperty("hibernate.connection.username", "sa")
            .setProperty("hibernate.connection.password", "")
            .setProperty("hibernate.connection.pool_size", "1")
            .setProperty("hibernate.connection.autocommit", "true")
            .setProperty("hibernate.cache.provider_class", "org.hibernate.cache.HashtableCacheProvider")
            .setProperty("hibernate.hbm2ddl.auto", "create-drop")  // 關鍵：每次 SessionFactory 建立重建 Schema
            .setProperty("hibernate.show_sql", "true")
            .addClass(Player.class)
            .addClass(BattingStint.class)
            .addClass(FieldingStint.class)
            .addClass(PitchingStint.class);

        HibernateUtil.setSessionFactory(config.buildSessionFactory());
    }

    // 輔助方法：添加/重置測試數據
    public static void addPlayer(Player p) { /* Hibernate save */ }
    public static void reset() { /* JDBC 批量 DELETE，注意外鍵順序 */ }
}

關鍵點解析

• jdbc:hsqldb:mem:testdb：純內存數據庫，JVM 結束即銷毀，零殘留。
• hbm2ddl.auto=create-drop：SessionFactory 建立時依映射自動建表，關閉時 Drop 表，保證每次測試 Schema 乾淨。
• HashtableCacheProvider：內存緩存，避免二級緩存干擾測試隔離性。
• 靜態初始化塊確保測試類載入時自動完成環境佈建，無需手動調用。

測試代碼範例

public class PlayerTest extends TestCase {
    @Override
    protected void setUp() throws Exception {
        TestSchema.reset();  // 每個測試方法前清空數據
    }

    public void testEligiblePositions() {
        Player player = new Player("p1");
        TestSchema.addPlayer(player);

        FieldingStint stint = new FieldingStint("p1", 2004, "SEA", Position.CATCHER);
        stint.setGames(20);
        TestSchema.addFieldingStint(stint);

        Set positions = player.getEligiblePositions(2004);
        assertEquals(1, positions.size());
        assertTrue(positions.contains(Position.CATCHER));
    }
}

進階技巧與避坑

1. 大量刪除效能：Hibernate 3 早期版本大量刪除需落回 JDBC，reset() 中直接用 session.connection() 批量 DELETE，注意關閉 Statement 而非 Connection（連接池 size=1，關閉連接會導致後續測試失效）。
2. 外鍵刪除順序：子表先刪（Batting, Fielding, Pitching），父表後刪。
3. 生產環境切換：實際部署用標準 hibernate.cfg.xml 配置真實資料庫與連接池，代碼零修改。
4. 適用性：同樣適用於 JDO、TopLink 等支援 Schema 生成的 ORM 框架。

效益總結

• 測試執行速度：從「分鐘級（含 DB 啟動/連接）」降為「秒級」。
• 完全隔離：並行測試互不干擾，CI 流水線零衝突。
• 發現真實 Bug：HQL/ Criteria 複雜查詢在真實 SQL 執行路徑下驗證，排除 Mock 掩蓋的問題。

HSQLDB + Hibernate 內存測試模式，是持久層 TDD 的「標準裝備」，輕量、快速、可靠，值得每個 Java 團隊納入標準化測試基礎設施。