Hibernate flush() 執行後拋出 Could not execute JDBC batch update 錯誤的排查

問題現象

程式執行至 session.flush() 時拋出 Could not execute JDBC batch update 例外，導致交易失敗。

可能原因

• 資料庫約束違規：主鍵重複、外鍵不存在、非空欄位為 null、唯一約束衝突等。
• 批次更新大小不當：hibernate.jdbc.batch_size 設定過大，超過資料庫限制（如 Oracle 批次上限）。
• 資料類型不匹配：實體欄位型別與資料庫欄位型別不相容（如 String 存入 NUMBER 欄位）。
• 觸發器/存儲過程錯誤：資料庫端觸發器拋出例外。
• 連線/交易問題：連線中斷、交易逾時、死結。

排查步驟

1. 查看完整堆疊追蹤：Caused by: java.sql.BatchUpdateException 之下通常包含具體 SQL 錯誤碼（如 ORA-00001、MySQL 1062）。
2. 開啟 SQL 日誌：在 hibernate.cfg.xml 或 persistence.xml 設定 hibernate.show_sql=true、hibernate.format_sql=true，並將 org.hibernate.SQL 設為 DEBUG 級別。
3. 檢查實體映射：確認 @Column(nullable=false, unique=true) 等約束與資料庫 DDL 一致。
4. 調整批次大小：嘗試設定 hibernate.jdbc.batch_size=20（預設常為 50），或暫時停用批次 hibernate.jdbc.batch_size=0 以縮小問題範圍。
5. 檢查 flush 前狀態：確認 session.flush() 前是否已正確 save()/update()/delete()，且無重複操作同一實體導致版本衝突（@Version）。

關於 flush() 與 clear() 的補充

• session.flush()：將 Session 快取中的異動（insert/update/delete）同步至資料庫，但不清除快取，實體仍處於 managed 狀態。
• session.clear()：完全清除 Session 快取，所有 managed 實體變為 detached。若在 flush() 後立即呼叫 clear()，後續對同一實體的操作需重新 merge() 或 load()。

若程式邏輯為「flush 後隨即 clear」，確認是否導致後續操作使用了已 detached 的實體，進而觸發非預期的 SQL。

常見解決案例

• 主鍵生成策略錯誤（如 Oracle sequence 未正確配置 @SequenceGenerator）。
• 大量資料匯入時未分批 commit，導致交易日誌暴增或鎖升級。
• 資料庫欄位長度不足（如 VARCHAR2(20) 存入 30 字元）。