JPA 2.0 vs Hibernate 緩存機制深度對比（一）：JPA 2.0 標準緩存 API 與二級緩存規範

前言：從 JPA 1.0 到 2.0 的緩存標準化里程碑

JPA 1.0 (JSR 220) 僅定義了一級緩存 (Persistence Context)，二級緩存完全由提供商自行實現，導致跨提供商遷移極難。JPA 2.0 (JSR 317, 2009) 引入標準化的 二級緩存 API (javax.persistence.Cache)、緩存模式枚舉、查詢提示，統一了緩存的基本操作與行為契約。本文深度解析 JPA 2.0 緩存規範、核心接口、啟用配置、以及與 Hibernate 實現的映射關係。

1. JPA 兩級緩存架構

2. 一級緩存：Persistence Context 深度解析

2.1 事務型 Persistence Context (預設)

@Stateless
public class EmpBean {
    @PersistenceContext
    EntityManager em;  // 隨事務開始/結束

    public Employee add(Employee e) {
        em.persist(e);  // e 變為 managed
        return e;       // 事務提交時 flush，返回 detached
    }

    public Employee update(Employee detached) {
        return em.merge(detached);  // 返回 managed 實例
    }
}

• 同一事務內多次 find/JPQL 返回同一實例 (== 比較為 true)。
• 事務結束 → 實體變為 detached，L1 緩存隨 EM 銷毀。

2.2 擴展型 Persistence Context (Stateful)

@Stateful
public class ShoppingCart {
    @PersistenceContext(type = PersistenceContextType.EXTENDED)
    EntityManager em;  // 隨 Stateful Bean 生命週期

    private Order order;  // 跨請求保持 managed

    public void addItem(Item item) {
        order.addItem(item);  // 直接操作 managed 實體，無需 merge
    }
}

• 跨多個請求/事務保持實體 managed 狀態，適用「長會話」場景 (向導式表單、購物車)。
• 風險：內存佔用增大、樂觀鎖衝突概率升高、需手動管理 em.clear()。

3. 二級緩存：標準 API 與配置

3.1 persistence.xml 啟用

<persistence-unit name="pu">
    <shared-cache-mode>ENABLE_SELECTIVE</shared-cache-mode> 
    <properties>
        <property name="hibernate.cache.use_second_level_cache" value="true"/>
        <property name="hibernate.cache.region.factory_class" value="org.hibernate.cache.ehcache.EhCacheRegionFactory"/>
    </properties>
</persistence-unit>

shared-cache-mode 四種模式：

• ALL：所有實體緩存 (除非 @Cacheable(false))。
• NONE：禁用二級緩存。
• ENABLE_SELECTIVE (推薦)：僅 @Cacheable(true) 實體緩存。
• DISABLE_SELECTIVE：預設緩存，@Cacheable(false) 排除。

3.2 實體註解

注意：@Cacheable 是 JPA 標準開關，具體並發策略/區域需用提供商註解 (@org.hibernate.annotations.Cache)。

3.3 標準 Cache 接口 (javax.persistence.Cache)

Cache cache = emf.getCache();  // 或 em.getEntityManagerFactory().getCache()

// 檢查實體是否在緩存
boolean exists = cache.contains(User.class, 1001L);

// 逐出單個實體
cache.evict(User.class, 1001L);

// 逐出整個實體類 (含子類)
cache.evict(User.class);

// 清空整個二級緩存
cache.evictAll();

限制：標準 API 僅提供基礎逐出操作，無法查詢統計、配置 TTL、區域劃分、預熱等進階功能。

4. 緩存模式：運行時動態控制

JPA 2.0 定義兩個枚舉，通過 Query.setHint() 或 EntityManager.find() 的 Map<String,Object> properties 傳遞：

使用範例

// 強制繞過緩存讀取最新數據
em.find(User.class, id, Map.of("javax.persistence.cache.retrieveMode", CacheRetrieveMode.BYPASS));

// 批量導入時不污染緩存
query.setHint("javax.persistence.cache.storeMode", CacheStoreMode.BYPASS);

// 刷新緩存 (如數據庫被外部系統修改)
em.find(User.class, id, Map.of("javax.persistence.cache.storeMode", CacheStoreMode.REFRESH));

5. 二級緩存優缺點權衡與適用場景

6. JPA 2.0 標準 vs Hibernate 實現：關鍵差異表

結語

JPA 2.0 為二級緩存建立了「最小可用標準」：@Cacheable、shared-cache-mode、CacheRetrieveMode/StoreMode、Cache 接口。這對於可移植性要求高、場景簡單的專案已足夠。但實際生產環境中，並發策略選擇、區域劃分、查詢緩存、分布式部署、統計監控 等關鍵能力均屬於提供商擴展領域。Hibernate 作為參考實現，提供了最完整、成熟的擴展生態。建議採用「標準註解開關 + 提供商註解精細控制」的混合模式，兼得可移植性與功能豐富度。

下篇預告：Hibernate 緩存架構深度解析、主流提供商 (Ehcache/Infinispan/Hazelcast/Redis) 整合實戰、生產環境調優清單、JCache (JSR-107) 標準化實踐。