Hibernate 新手必遇兩大報錯：MappingException 與 Cascade 錯誤速查

Hibernate 新手必遇兩大報錯：MappingException 與 Cascade 錯誤速查

錯誤 1：Could not get constructor for SingleTableEntityPersister

現象：啟動報 org.hibernate.MappingException，堆棧指向實體持久化器構造失敗。

排查清單：

1. 映射文件與實體類屬性一一對應：<property name="xxx" column="xxx"/> 名稱、類型、長度完全一致。
2. 無參構造器是否存在：Hibernate 要求實體類提供 public/protected 無參構造器。
3. Getter/Setter 規範：遵循 JavaBean 標準，Boolean 類型用 isXxx() 而非 getXxx()。
4. 終極大招：IDE 重新生成構造器、Getter/Setter（Alt+Insert），消除隱形字符/緩存不一致。

錯誤 2：Unsupported cascade style: true

現象：映射文件中 <set cascade="true"/> 或 <many-to-one cascade="true"/> 拋異常。

根因：cascade 屬性值必須是枚舉常量，不能寫 true/false。

合法值：

• none（默認，無級聯）
• save-update：持久化/更新時級聯
• delete：刪除時級聯
• all：包含以上所有 + lock/merge/refresh
• all-delete-orphan：刪除孤兒對象（一對多常用）

修正示例：

<!-- 錯誤 -->
<set name="children" cascade="true">...</set>

<!-- 正確 -->
<set name="children" cascade="all-delete-orphan">...</set>

避坑心法

• 映射文件修改後 清理 target/out 目錄重新編譯，防止舊 class 干擾。
• 善用 hbm2ddl.auto=validate 啟動時校驗映射一致性。
• 註解配置（@OneToMany(cascade=CascadeType.ALL)）類型安全，優先考慮。

這兩個錯誤覆蓋了 80% 新手映射問題，收藏備查，事半功倍。