Hibernate 3 學習筆記（三）：Log4j 日誌配置詳解與調試實戰

為什麼需要 Log4j？

Hibernate 內部採用 Apache Commons Logging 抽象層，預設綁定 Log4j 實現。配置 log4j.properties 不僅能控制輸出格式、級別、目的地，更是開發階段「看見 SQL」與「排查異常」的核心工具。

標準配置文件模板

### 輸出到控制台 ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n

### 輸出到文件（按需啟用） ###
#log4j.appender.file=org.apache.log4j.FileAppender
#log4j.appender.file.File=hibernate.log
#log4j.appender.file.layout=org.apache.log4j.PatternLayout
#log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n

### 根級別：warn 級別輸出到 stdout ###
log4j.rootLogger=warn, stdout

### Hibernate 核心日誌級別 ###
#log4j.logger.org.hibernate=info
log4j.logger.org.hibernate=debug

### 專項調試開關（按需取消註釋） ###
# HQL 解析器活動
#log4j.logger.org.hibernate.hql.ast.AST=debug
# 僅輸出 SQL
#log4j.logger.org.hibernate.SQL=debug
# JDBC 參數綁定詳情（極其有用）
log4j.logger.org.hibernate.type=info
#log4j.logger.org.hibernate.type=debug
# Schema 生成/更新
log4j.logger.org.hibernate.tool.hbm2ddl=debug
# HQL 解析樹
#log4j.logger.org.hibernate.hql=debug
# 二級緩存活動
#log4j.logger.org.hibernate.cache=debug
# 事務活動
#log4j.logger.org.hibernate.transaction=debug
# JDBC 連接獲取
#log4j.logger.org.hibernate.jdbc=debug
# 連接洩漏追蹤
#log4j.logger.org.hibernate.connection.DriverManagerConnectionProvider=trace

日誌級別對輸出的影響

實戰案例：從啟動到執行 INSERT 的完整日誌剖析

設置 debug 級別後，控制台將輸出數百行日誌，關鍵節點如下：

1. 配置加載：讀取 hibernate.cfg.xml、映射文件、解析 DTD
2. SessionFactory 構建：方言檢測、連接池初始化、SQL 语句預編譯緩存
3. 事務開啟：JDBC 連接獲取、自動提交關閉
4. SQL 執行：select hibernate_sequence.nextval from dual（Oracle 序列取值） → INSERT ... values (?, ?, ...)
5. 參數綁定：若開啟 org.hibernate.type=debug，可見每個 ? 對應的實際值
6. 提交與釋放：Flush、Commit、Connection 歸還池中

最佳實踐建議

• 開發期：org.hibernate=debug + org.hibernate.type=info，既能看 SQL 又能見參數，不至于刷屏
• 測試期：開啟 org.hibernate.SQL=debug 專門做 SQL 審計
• 生產期：org.hibernate=error 或 warn，僅保留異常與慢查詢告警
• 性能調優：臨時開啟 org.hibernate.cache=debug 觀察二級緩存命中率

總結

Log4j 配置沒有銀彈，「多輸出利於診斷，少輸出利於性能」。建議在專案中維護多套配置文件（如 log4j-dev.properties、log4j-prod.properties），通過構建工具或啟動參數動態切換，做到心中有數、按需開啟。