Hibernate 整合 Oracle Sequence 實現主鍵自增：配置詳解與最佳實踐

在使用 Oracle 數據庫時，SEQUENCE 是生成唯一主鍵的標準機制。Hibernate 通過 sequence 生成器原生支持 Oracle Sequence，無需手寫 SQL 查詢 SELECT seq.nextval FROM dual。本文詳細講解 Sequence 創建、Hibernate 映射配置（XML 與註解）、生成策略選型、常見問題與優化建議。

Oracle 端：創建 Sequence

CREATE SEQUENCE seq_id
    MINVALUE 1
    START WITH 1
    INCREMENT BY 1
    CACHE 20;          -- 關鍵優化：內存預分配 20 個值，減少字典鎖競爭
-- 可選參數：
-- NOCYCLE           -- 達到最大值不循環 (默認)
-- NOORDER           -- 不保證順序 (默認，RAC 環境建議 ORDER)

• CACHE：極大提升高併發插入性能。缺點：實例崩潰/關閉會丟失緩存值（導致主鍵不連續，**業務通常可接受**）。
• RAC 環境：建議添加 ORDER 保證全局遞增序列，或使用 NOCACHE 避免節點間緩存不一致導致重複（極罕見）。

Hibernate 映射配置

方式一：XML 映射文件 (.hbm.xml)

<id name="id" column="ID0000" type="long">
    <generator class="sequence">
        <param name="sequence">seq_id</param>  <!-- 必須指定 Sequence 名稱 -->
    </generator>
</id>

方式二：JPA 註解 (Hibernate 5+/JPA 2.1+)

@Entity
@Table(name = "YXJK_WHRYTXL")
public class Contact {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "seq_gen")
    @SequenceGenerator(
        name = "seq_gen",
        sequenceName = "seq_id",      // 數據庫 Sequence 名
        allocationSize = 20           // **必須與 Sequence CACHE 一致**
    )
    @Column(name = "ID0000")
    private Long id;
    // ...
}

關鍵點：allocationSize (默認 50) **必須等於 Oracle Sequence 的 CACHE 值**。不一致會導致 Hibernate 內存分配塊與數據庫實際值脫節，造成主鍵重複或大量跳空。

生成策略對比：sequence vs identity vs native

Hibernate 執行流程與 SQL 日志

配置正確時，插入實體會生成如下 SQL：

Hibernate: select seq_id.nextval from dual        -- 獲取下一個序列值
Hibernate: insert into YXJK.T_YXJK_WHRYTXL (XM0000, ZW0000, LXDH00, SJHM00, DZYJ00, IP0000, ID0000) values (?, ?, ?, ?, ?, ?, ?)

• Hibernate 先調用 SELECT seq_id.nextval FROM dual 獲取值，設置到實體 id 字段，再執行 INSERT。
• 若配置 allocationSize > 1 (對應 Sequence CACHE)，Hibernate 會**內存預分配塊**，僅在塊用盡時發起 nextval 調用，**大幅減少數據庫往返**。

進階優化：增強型生成器 (Hibernate 5+)

新版 Hibernate 提供 enhanced-sequence / SequenceStyleGenerator，支持更智能的優化：

@GenericGenerator(
    name = "seq_gen",
    strategy = "enhanced-sequence",
    parameters = {
        @Parameter(name = "sequence_name", value = "seq_id"),
        @Parameter(name = "initial_value", value = "1"),
        @Parameter(name = "increment_size", value = "20"),  // 對應 CACHE
        @Parameter(name = "optimizer", value = "pooled-lo") // 或 pooled, hilo, none
    }
)
@GeneratedValue(generator = "seq_gen")

最佳實踐：生產環境**強烈建議使用 optimizer="pooled-lo"**，配合 increment_size = Sequence CACHE，兼顧性能與安全性。

常見問題排查

總結：落地檢查清單

1. Oracle 創建 CREATE SEQUENCE seq_name CACHE 20; (高併發可調大至 50-100)。
2. Hibernate 映射顯式指定 generator class="sequence" + param name="sequence"。
3. JPA 註解：@SequenceGenerator(allocationSize = 20) **等於 CACHE 值**。
4. 升級 Hibernate 5+ 使用 enhanced-sequence + optimizer="pooled-lo"。
5. 禁用業務代碼手動設置 ID，交由框架全權管理。
6. 測試驗證：並發插入 1000 條，檢查主鍵唯一、無重複、性能達標。

遵循以上規範，即可在 Hibernate + Oracle 架構下實現高性能、安全、可維護的主鍵自增方案。