您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Hibernate save() vs persist() 深度對比：返回值、SQL 觸發時機、長會話適用性

編輯：Java 相關知識

前言

Hibernate 提供 save() 與 persist() 兩個看似相同的持久化方法，實則在返回值、SQL 發送時機、長會話場景有關鍵差異。選錯會導致主鍵獲取失敗、事務邊界混亂、效能退化。本文深度對比並給出選型建議。

一、核心差異速查表

維度	save()	persist()
返回值	可序列化的主鍵值 (即生成的 ID)	void (無返回值)
INSERT 發送時機	立即執行 (為獲取 ID)	可延遲至 `flush()` 或事務提交
事務邊界要求	無特殊要求	必須在事務中，否則拋異常
長會話適用性	差 (過早 INSERT 佔用連接、鎖)	優 (延遲 INSERT，批次優化)
JPA 標準	非標準 (Hibernate 專有)	標準 (`EntityManager.persist()`)
游離對象調用	嘗試 INSERT (可能重複主鍵)	拋 `EntityExistsException`

二、原始碼層面解析 (Hibernate 5.4)

save() 關鍵邏輯

public Serializable save(Object object) {
    // 1. 立即執行 SaveOrUpdateEvent
    // 2. 若 id 為 null，執行 Insert 生成 id
    // 3. 返回生成的 id
    return getSession().save(object); // 內部調用 ActionQueue.addInsertAction
}

關鍵點：為了返回 ID，必須立即執行 INSERT，無法受益於批次插入 (hibernate.jdbc.batch_size)。

persist() 關鍵邏輯

public void persist(Object object) {
    // 1. 檢查是否在事務中，否則拋異常
    // 2. 標記實體為 PERSISTENT，加入 ActionQueue
    // 3. INSERT 延遲至 flush() / commit()
    getSession().persist(object);
}

三、實戰場景對比

場景 1：需要立即獲取生成的 ID 給前端/後續邏輯用

// save() 適用
Long id = (Long) session.save(user);
return ResponseEntity.ok(id); // 立即返回 ID

場景 2：批量導入 10 萬條訂單，事務末尾統一提交

// persist() 適用，配合批次插入
session.setFlushMode(FlushMode.MANUAL);
for (Order o : orders) session.persist(o);
if (i % 50 == 0) { session.flush(); session.clear(); } // 批次刷新
session.flush(); // 統一發送 INSERT

save() 會導致每次循環立即 INSERT，無法批次，效能差 10-100 倍。

場景 3：長會話 (Conversation) 模式，用戶編輯草稿多次保存最後才提交

// 持久化上下文保持開啟
@Transactional
public void saveDraft(Article draft) {
    if (draft.getId() == null) session.persist(draft); // 延遲 INSERT
    else session.merge(draft);
}
// 用戶點「發布」時才 commit，期間草稿可多次修改無額外 INSERT

四、最佳實踐建議

新專案優先用 persist()：符合 JPA 標準、支援批次、長會話友好。
僅在「必須立即拿到生成 ID」時用 save()，且確認不需批次優化。
避免在無事務環境調用 persist()：會拋 TransactionRequiredException。
配合 @GeneratedValue：ID 生成策略 (IDENTITY/SEQUENCE/TABLE) 影響 INSERT 時機，IDENTITY 需立即 INSERT 才能取 ID，此時 save/persist 行為趨同。
遷移舊代碼：將無事務邊界的 save() 改為 persist() 並補充 @Transactional。