Hibernate 主鍵生成策略全景指南：從 assigned 到 uuid.hex 選型決策

四、生產環境最佳實踐

1. 推薦：uuid.hex + 字符串主鍵（通用最優）

<id name="id" column="id" type="string" length="32">
    <generator class="uuid.hex"/>
</id>

• 表定義：id CHAR(32) PRIMARY KEY 或 VARCHAR(32)。
• 插入前生成：String id = UUID.randomUUID().toString().replace("-", "");（等同 uuid.hex）。

2. 進階：有序 UUID (COMB/TSID/雪花) 兼顧插入性能與索引局部性

• 原理：高位時間戳 + 低位隨機/節點ID，保持大致遞增，減少 B+ 樹分頁分裂。
• 庫推薦：com.github.f4b6a3:tsid-java (TSID)、com.baomidou:mybatis-plus-generator (雪花)。

3. 避坑指南

• 禁用 increment：任何可能水平擴展的系統，increment 都是定時炸彈。
• native 謹慎用：遷移數據庫時行為突變（如 MySQL→Oracle 從 identity 變 sequence），導致主鍵類型不匹配。
• assigned 需業務保證：配合分布式 ID 生成服務（Redis INCR、ZooKeeper、數據庫分段號段）。
• 主鍵類型一致性：關聯表外鍵類型必須與主表主鍵類型完全一致（長度、字符集、collation）。

五、JPA/Hibernate 註解配置速查

// uuid.hex
@Id @GeneratedValue(generator = "uuid")
@GenericGenerator(name = "uuid", strategy = "uuid.hex")
@Column(length = 32)
private String id;

// identity (MySQL)
@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

// sequence (Oracle/PostgreSQL)
@Id @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "seq_gen")
@SequenceGenerator(name = "seq_gen", sequenceName = "seq_table", allocationSize = 50)
private Long id;

// assigned (手動設置)
@Id @GeneratedValue(strategy = GenerationType.IDENTITY) // JPA 無 assigned，用 IDENTITY 模擬或不加 GeneratedValue
private String id;

主鍵策略選擇沒有標準答案，只有架構約束下的最優解。現代雲原生、微服務、多活架構下，uuid.hex 或有序 UUID 是默認首選，以換取無協調擴展能力與遷移靈活性；單體傳統系統繼續用數據庫原生機制無可厚非。關鍵是：在架構設計階段確定，上線後嚴禁變更。