Spring + Hibernate 向 PostgreSQL 插入資料失敗的排查思路

控制台錯誤資訊分析

日誌顯示 Hibernate 已生成 SQL 插入語句，但資料未寫入，且隨後載入了 Spring 的 SQL 錯誤碼對應檔案，最後輸出「存入失敗」。

常見原因與檢查步驟

1. 欄位型別不匹配：實體類屬性型別與資料表欄位型別是否一致（如 String 對應 VARCHAR、Date 對應 TIMESTAMP）。
2. 欄位名稱大小寫：PostgreSQL 預設小寫，若實體類使用駝峰命名，需透過 @Column(name = "customer_name") 明確指定。
3. 主鍵生成策略：確認 @GeneratedValue 策略與資料庫序列或身份欄位一致。
4. 事務管理：檢查 @Transactional 是否正確配置，事務是否正常提交。
5. 約束違反：非空、唯一、外鍵約束是否觸發例外（需開啟 DEBUG 日誌查看完整堆疊追蹤）。

建議操作

開啟 Hibernate SQL 日誌（hibernate.show_sql=true），並設定 org.hibernate.type=trace 以查看參數綁定值，對照資料表結構逐一核對。