Hibernate 核心配置全解析：從連線池、方言到效能關鍵參數調校

Hibernate 配置檔支援 hibernate.properties 與 hibernate.cfg.xml 兩種格式，後者較便利 (映射檔可直接在 XML 宣告)。本文系統整理所有核心配置項，重點揭秘 fetch_size、batch_size 等決定效能生死的關鍵參數。

配置檔範本來源

Hibernate 發布包 src/ 目錄下含 hibernate.properties 範本，修改即用。

核心配置分類詳解

1. 查詢轉換與基礎設定

hibernate.query.substitutions true 1, false 0, yes 'Y', no 'N'

HQL/標準布林值映射至資料庫實際值 (Oracle 無 boolean，用 1/0 或 Y/N)，讓代碼更直觀。

2. 資料庫連線配置

內建連線池 (僅開發/測試用)

hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.driver_class com.mysql.jdbc.Driver
hibernate.connection.url jdbc:mysql://host/db
hibernate.connection.username root
hibernate.connection.password xxx

hibernate.connection.pool_size 1
hibernate.statement_cache.size 25

警告： 內建連線池極簡陋，**生產環境嚴禁使用**。優先順序：App Server DataSource > DBCP/Proxool > 內建池。

DBCP 連線池

hibernate.connection.provider_class net.sf.hibernate.connection.DBCPConnectionProvider
# 另需 DBCP 專屬配置 (maxActive, maxIdle 等)

App Server DataSource (生產首選)

hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.datasource mypool  # JNDI 名稱
hibernate.connection.provider_class net.sf.hibernate.connection.DatasourceConnectionProvider

其他連線參數由 App Server 管理，無需重複配置。

遠端客戶端使用 App Server DataSource

hibernate.jndi.class weblogic.jndi.WLInitialContextFactory
hibernate.jndi.url t3://servername:7001/

3. 交易管理

# JTA 交易 (EJB 環境)
hibernate.transaction.factory_class net.sf.hibernate.transaction.JTATransactionFactory

4. 雜項與效能關鍵參數 ⭐⭐⭐

SQL 顯示 (除錯神器)

hibernate.show_sql false  # 開發階段建議 true

輸出 Hibernate 發送給資料庫的實際 SQL，快速定位問題。

隔離級別

# hibernate.connection.isolation 4  # 視資料庫支援而定，通常不用動

Fetch Size — 讀取效能關鍵

hibernate.jdbc.fetch_size 50

• 定義： JDBC Statement 每次從資料庫抓取的記錄筆數
• 原理： 類比檔案 I/O 緩衝區。查詢 1 萬筆，Oracle JDBC 預設 fetch_size=10 需 1000 次網路往返；設 50 只要 200 次
• 實測 (Oracle)： 10→50 效能提升 **1 倍**；50→100 再提升 20%；100 以上不顯著
• 建議： Oracle **務必設 50**；MySQL **不支援**此特性 (一次全抓，記憶體壓力大)

Batch Size — 批量寫入效能關鍵

hibernate.jdbc.batch_size 25

• 定義： 批量 INSERT/UPDATE/DELETE 的批次大小
• 實測 (Oracle 刪 1 萬筆)： 0 (無批次) 耗 25 秒；50 耗 **5 秒** (5 倍提升！)
• 原理： 減少 SQL 發送網路往返，類比緩衝區寫入
• 建議： Oracle **30~50** 最佳；50 以上效能增益微小但記憶體增長
• 注意： 許多 Hibernate vs JDBC 效能測試誤以為 Hibernate 慢，實則是 JDBC 未啟用批次

可捲動結果集

# hibernate.jdbc.use_scrollable_resultset true  # 分頁相關，預設即可

CGLIB 反射優化

# hibernate.cglib.use_reflection_optimizer false  # 預設開啟

• 動態生成 PO 位元碼加速存取
• 除錯時若錯誤訊息模糊 (特別是 proxy/lazy loading 相關)，可關閉以獲得詳細堆疊

配置最佳實踐清單

1. 區分環境： 開發用內建池 + show_sql=true；生產用 App Server DataSource + show_sql=false
2. Oracle 必調參數： fetch_size=50、batch_size=30~50
3. MySQL 注意： 不支援 fetch_size，大量查詢需分頁或游標處理記憶體
4. Dialect 必正確： 決定 SQL 生成方言、關鍵字轉義、鎖語法等
5. 統一用 cfg.xml： 映射檔註冊、屬性繼承、環境切換更方便

掌握這些配置，特別是 fetch_size 與 batch_size，是 Hibernate 專案從「跑得動」到「跑得快」的分水嶺。