Hibernate 核心原理與架構深度解析：初始化、快取、物件狀態

Hibernate 作為 Java 持久層標杆框架，其核心價值在於透明化物件關係映射 (ORM)、提供多層級快取機制、管理實體物件生命週期。本文系統梳理 Hibernate 初始化流程、雙層快取架構、三大物件狀態轉換，助你建立完整心智模型。

一、Hibernate 初始化流程：從配置到 SessionFactory

啟動過程分四步，核心是建立線程安全、重量級的 SessionFactory：

1. 建立 Configuration：讀取 hibernate.cfg.xml (或 hibernate.properties) 及映射檔 (*.hbm.xml / 註解類)，在記憶體構建完整配置元資料模型。
   Configuration cfg = new Configuration().configure();
2. 建立 SessionFactory：SessionFactory sf = cfg.buildSessionFactory();
   將 Configuration 中的配置、映射元資料、預編譯 SQL 複製到 SessionFactory 內部快取。此後 Configuration 可丟棄，SessionFactory 獨立存在，代表一個資料來源。
3. 開啟 Session：兩種方式：
   • 自管連線：Session s = sf.openSession(myConnection);
   • Hibernate 管連線 (常用)：Session s = sf.openSession(); 從配置的連線池 (C3P0/DBCP/Hikari) 取得連線。
4. 透過 Session API 操作資料庫：save(), get(), load(), createQuery() 等。

關鍵點：SessionFactory 是單例、不可變、線程安全的重量級物件，應用生命週期只建一次；Session 是輕量級、非線程安全、請求範圍的單位工作。

二、Hibernate 雙層快取架構

1. 一級快取 (L1 Cache) - Session 級

• 內建、不可關閉：每個 Session 獨擁一份，存放該 Session 載入/持久化的實體。
• 隔離性：不同 Session 看不到彼此的一級快取內容。
• 生命週期：隨 Session 開啟/關閉。session.clear() 可手動清空。
• 作用：保證同一 Session 內多次 get/load 同一 ID 返回同一物件實例 (== 比較為 true)，實現「同一事務內物件唯一性」。

2. 二級快取 (L2 Cache) - SessionFactory 級

• 外掛、可插拔：需整合 Ehcache、Infinispan、Redis 等實現 CacheProvider。
• 跨 Session 共享：多個 Session 可讀取同一份快取資料，大幅減少資料庫查詢。
• 配置粒度：類級 (<class-cache>)、集合級 (<collection-cache>)、查詢級 (Query.setCacheable(true))。
• 策略：read-only (唯讀、最高效)、read-write (讀寫)、nonstrict-read-write (非嚴格讀寫)、transactional (JTA 事務)。

3. SessionFactory 內建快取 (非業務資料)

存放映射元資料 (實體/屬性/關聯定義)、預編譯 SQL (Named Query、Criteria 編譯結果)、ID 生成器狀態 等，屬於框架基礎設施，非使用者資料快取。

三、Hibernate 物件三大狀態與轉換

理解狀態機是掌握 Hibernate 行為的關鍵：

狀態轉換圖解

      new()          save/persist()           close/evict
Transient  ---------------->  Persistent  ------------------>  Detached
      ^                         |    ^                         |
      |                         |    | update/saveOrUpdate/merge
      |          delete()       |    |                         |
      +-------------------------+    +-------------------------+
           (DB record also deleted)      (re-attach to new Session)

四、常見誤區與最佳實踐

• 誤區：load() 拋出 ObjectNotFoundException 時物件仍是 Persistent？
  事實：load() 可能返回代理，異常拋出時該代理未關聯 Session，屬 Transient/Detached 邊界狀態。
• 誤區：evict() 能提升效能？
  事實：僅在極大量批次處理需手動清理快取釋放記憶體時使用，濫用會破壞一級快取一致性。
• 最佳實踐：saveOrUpdate() / merge() 處理遊離物件重新關聯；優先用 merge() (JPA 標準)，返回新的 Persistent 實例，避免原實例狀態混淆。
• 二級快取：唯讀/極少寫入的參考資料 (字典表、配置表) 必開；高併發寫入表慎開，否則頻繁失效反而拖慢效能。

總結

Hibernate 的精髓在於：SessionFactory 封裝不可變元資料與二級快取，Session 封裝一級快取與資料庫對話，實體物件在三態間流轉。深入理解初始化鏈路、快取層級職責、狀態轉換觸發條件，才能寫出高效、正確、易維護的持久層代碼，並能從容排查 LazyInitializationException、StaleObjectStateException 等經典疑難雜症。