Hibernate 自我關聯一對多映射陷阱與 Struts FormBean 作用域解決方案

問題背景：自我關聯映射的奇異行為

在使用 Hibernate 實現實體類的自我關聯（一對多）時，開發者常遇到一個令人費解的現象：明明邏輯分離的兩個保存操作，卻在特定序列下產生交叉干擾。本文記錄一個真實案例，剖析其根因並給出解決方案。

映射配置

實體 Catalog 通過 parentCatalog（多對一）與 childCatalogs（一對多，inverse="true"、cascade="save-update"）形成樹狀結構：

<many-to-one name="parentCatalog" class="com.example.Catalog">
    <column name="catalog_id"/>
</many-to-one>
<set name="childCatalogs" cascade="save-update" inverse="true" lazy="false">
    <key><column name="catalog_id"/></key>
    <one-to-many class="com.example.Catalog"/>
</set>

兩個業務方法

• A 方法：保存頂級節點（無父關聯），直接 session.save(catalog)。
• B 方法：根據父 ID 獲取父節點，將新節點加入其子集合並設定雙向關聯，隨後 session.save(parent) 與 session.save(child) 雙重保存。

詭異現象

1. 單獨重複執行 A 或 B 均正常。
2. 一旦執行過 B 方法，後續的 A 方法竟會變為「在最後一次 B 操作的父節點下新增子節點」。
3. 無法在同層級插入節點（如在 ID=2 下新增 ID=4），只能無限向下延伸（在 ID=3 下新增 ID=4）。
4. 關閉瀏覽器重開後，A 方法恢復正常，同層插入也可行；但再次使用 B 方法後問題復發。

根因分析：Struts FormBean 的 Session 作用域

問題核心在於 Struts ActionForm 默認作用域為 session。當表單提交時，FormBean 實例存活於 Session 中，攜帶著上一次請求的屬性值（如 parentId、catalog 物件引用）。

B 方法執行後，FormBean 保留了父節點引用與子節點關聯。下一次請求進入 A 方法時，Struts 復用同一 FormBean 實例，導致「無父節點」的 A 方法實際上操作的是殘留在 FormBean 中的父節點物件，從而誤觸發級聯保存邏輯。

解決方案

在 struts-config.xml 中將該 FormBean 的作用域顯式設為 request：

<form-bean name="catalogForm" type="com.example.CatalogForm" scope="request"/>

或在 Action 中手動 form.reset(mapping, request) 清理狀態。修改後，每次請求獲得全新 FormBean 實例，問題徹底消失。

最佳實踐提醒

• 涉及複雜關聯操作時，避免在 FormBean 中持有領域模型物件引用，改用 ID 傳遞並在 Action 中重新加載。
• 優先使用 request 作用域，除非確有跨請求共享表單數據的需求。
• Hibernate 級聯保存雖強大，但需配合正確的 Web 層狀態管理，否則極易產生「幽靈關聯」。