Hibernate hbm.xml generator 節點主鍵生成策略詳解與常見坑

常用 generator class 屬性值

常見錯誤場景

1. assigned 但未設值

Exception: ids for this class must be manually assigned before calling save()

解決：entity.setId(value) 後再 save()。

2. increment 用於空表

Hibernate 會先 SELECT MAX(id) FROM table，空表回傳 NULL → 轉為 0 → 嘗試 INSERT id=0 → 若主鍵為 NOT NULL 可能成功，但並發極易重複。

解決：

• 改用 sequence（需建立 Sequence）。
• 或確保表已有資料再用 increment。
• 生產環境嚴禁使用 increment。

最佳實務建議

1. Oracle：優先 sequence，搭配 allocationSize 優化效能。
2. MySQL/PostgreSQL：使用 identity 或 native。
3. 分散式/微服務：uuid 或 guid 避免協調成本。
4. 避免 increment、native 在叢集環境產生衝突。

範例配置

<id name="id" type="long">
  <generator class="sequence">
    <param name="sequence">SEQ_STUDENT</param>
  </generator>
</id>

<id name="id" type="string">
  <generator class="uuid"/>
</id>