Hibernate 集合映射詳解：List vs Bag vs Set 語義差異、索引維護與性能選型指南

集合映射核心接口對應表

List 映射：有序集合的精確控制

映射配置 (註解/XML)

// 註解方式
@OneToMany(mappedBy = "parent")
@OrderColumn(name = "display_order") // 關鍵：維護索引列
private List children = new ArrayList<>();

// XML 方式
<list name="children" cascade="all-delete-orphan">
    <key column="parent_id"/>
    <list-index column="display_order"/> <!-- 索引列 -->
    <one-to-many class="Child"/>
</list>

核心機制

• @OrderColumn / <list-index> 指定**索引列**，Hibernate 自動維護 0-based 索引值。
• 插入/刪除/移動元素時，Hibernate 會**批量更新**受影響行的索引值 (如在索引 1 插入，後續所有元素索引 +1)。
• 性能陷阱：大列表頻繁中間插刪會導致大量 UPDATE SQL。建議僅在「列表較小、順序業務關鍵、尾部操作為主」場景使用。

最佳實踐

1. 實體類字段聲明為 List (而非 ArrayList) 以便 Hibernate 注入持久化包裝器。
2. 初始化：private List children = new ArrayList<>();
3. 避免在業務代碼中直接操作索引，交由 Hibernate 管理。

Bag 映射：最簡單的「包」語義

映射配置

// 註解 (Hibernate 擴展)
@OneToMany(mappedBy = "parent")
@org.hibernate.annotations.CollectionType(type = "bag") // 或直接用 List 不加 @OrderColumn
private List children = new ArrayList<>();

// XML
<bag name="children" cascade="all-delete-orphan">
    <key column="parent_id"/>
    <one-to-many class="Child"/>
</bag>

特點與代價

• 無索引列：數據庫關聯表僅有外鍵 parent_id，允許重複行 (同一父對象關聯多個完全相同的子對象)。
• 無法精確刪除單條記錄：移除集合中某元素時，Hibernate **無法定位唯一行**，只能 **刪除該父對象所有關聯記錄，再重新插入剩餘元素**。
• 性能殺手：集合大小為 N，移除 1 個元素 → N 次 DELETE + (N-1) 次 INSERT。

適用場景

• 極小集合 (N < 10)。
• 純只讀/極少修改集合內容。
• 不關心順序、允許重複、且不介意全量重寫的場景。

idBag 映射：Bag 的改良版

<idbag name="children" cascade="all-delete-orphan">
    <collection-id column="id" type="long">
        <generator class="identity"/>
    </collection-id>
    <key column="parent_id"/>
    <one-to-many class="Child"/>
</idbag>

• 引入**代理主鍵** (collection-id)，每行唯一標識。
• 移除元素可精確定位行 → **單條 DELETE**，性能大幅優於 Bag。
• 但仍**無序**，不保證加載順序 (通常按主鍵順序)。

Set 映射：去重與關聯管理的標準選擇

• 無索引列，主鍵為 (parent_id, child_columns...)。
• 依賴子實體正確實現 equals() 和 hashCode() (基於業務鍵，非 ID)。
• 移除/添加元素 → 單條 DELETE/INSERT，性能優異。
• **推薦作為默認集合類型**，除非業務強制要求有序或允許重複。

性能與選型決策樹

開始
  │
  ├─ 需要保持插入順序/支持索引訪問？ ──是──► List (小數據量/尾部操作) / 獨立排序字段 + Set
  │
  ├─ 允許重複元素？ ──是──► idBag (中大數據量) / Bag (極小/只讀)
  │
  └─ 否 (不重複、無序) ──► Set (默認首選)

避坑指南

1. List 索引列不可為空：nullable=false，否則加載報錯。
2. Bag/idBag 無法使用 @OrderBy：加載順序不確定，若需排序請在查詢層 ORDER BY 或改用 List/Set + Comparator。
3. Set 要求子實體不可變業務鍵：業務鍵變更會導致 Set 行為異常 (重複/丟失)。
4. orphanRemoval=true：配合 cascade=ALL 實現「從集合移除即刪除實體」，適用於強生命周期綁定的聚合根。

總結

List = 有序 + 索引維護成本高；Bag = 無序 + 全量重寫極差；idBag = Bag + 代理鍵優化；Set = 無序去重 + 高性能 + 標準語義。 90% 場景首選 Set，有序場景評估 List 成本或「Set + 業務排序字段」方案，慎用 Bag。