Hibernate TableGenerator 深度解析：新舊生成器差異與優化策略

問題背景

在使用 JPA @TableGenerator 時設置 initialValue=10，預期主鍵從 11 開始生成，實際卻報主鍵衝突從 1 開始。根源在於 Hibernate 對 TableGenerator 有新舊兩種實現，默認使用舊版，導致 JPA 標準參數失效。

JPA 主鍵生成策略對比

對不支持 SEQUENCE 的數據庫，TABLE 是唯一兼顧性能與通用性的選擇。

新舊 TableGenerator 差異

兩個實現類

• 舊版：org.hibernate.id.TableGenerator（默認）
• 新版：org.hibernate.id.enhanced.TableGenerator

啟用新生成器

<property name="hibernate.id.new_generator_mappings" value="true"/>

Hibernate 官方建議：所有新項目必須啟用，新生成器更高效、更符合 JPA 2 標準。舊項目升級需謹慎，因主鍵生成邏輯不兼容可能導致衝突。

新 TableGenerator 參數詳解

新生成器支持 8 個配置參數，分為兩組：

輔助表結構參數（前5個）

支持單表存儲多個序列（segment），避免創建大量輔助表。

生成算法參數（後3個）

優化器機制深度解析

五種優化器

優化器選擇邏輯

if (increment_size == 1) → none
else if (prefer_lo) → pooled-lo
else → pooled

默認 prefer_lo = false，故大多數情況選 pooled。

數值含義示例

假設 increment_size=50，當前分配到主鍵 60：

建議：設置 hibernate.id.optimizer.pooled.prefer_lo=true 使用 pooled-lo，輔助表值更符合直覺。

關於「空洞」問題

重啟應用導致未用完的號段丟失（如 61-100 永不使用）。這是正常現象，主鍵唯一性不要求連續性，無需焦慮。數據庫主鍵空洞不影響業務邏輯。

完整配置示例

JPA 註解方式（需啟用新生成器）

@Entity
@Table(name="emp3")
public class Employee3 {
    @TableGenerator(
        name="id_gen", 
        table="id_gen", 
        initialValue=10,
        allocationSize=50  // 對應 increment_size
    )
    @Id
    @GeneratedValue(strategy=TABLE, generator="id_gen")
    private long id;
    ...
}

Hibernate 原生註解方式（功能更全）

@Entity
@Table(name="emp4")
public class Employee4 {
    @GenericGenerator(
        name="id_gen",
        strategy="enhanced-table",
        parameters = {
            @Parameter(name="table_name", value="enhanced_gen"),
            @Parameter(name="value_column_name", value="next_val"),
            @Parameter(name="segment_column_name", value="sequence_name"),
            @Parameter(name="segment_value", value="emp_seq"),
            @Parameter(name="increment_size", value="10"),
            @Parameter(name="optimizer", value="pooled-lo")
        }
    )
    @Id
    @GeneratedValue(generator="id_gen")
    private long id;
    ...
}

新生成器名稱在 DefaultIdentifierGeneratorFactory 中註冊為 "enhanced-table"。

最佳實踐總結

1. 新項目必啟用：hibernate.id.new_generator_mappings=true
2. 設置 allocationSize：建議 50-100，避免頻繁數據庫往返
3. 使用 pooled-lo：optimizer=pooled-lo + prefer_lo=true
4. 單表多序列：配置 segment_value 區分業務實體
5. 接受空洞：主鍵不連續是正常現象，無業務影響

總結

Hibernate 新 TableGenerator 解決了舊版不符合 JPA 標準、性能差、配置受限等問題。通過優化器機制（pooled/pooled-lo）實現號段預分配，大幅減少數據庫訪問。正確配置初始值、步長、優化策略，能構建高性能、標準兼容的主鍵生成方案。