Hibernate 緩存機制深度解析：一級緩存與二級緩存實戰

緩存架構概覽

Hibernate 緩存分為兩級：一級緩存 (Session 級) 與 二級緩存 (SessionFactory 級)。理解其生命週期、作用域與配置方式，是優化 ORM 性能的關鍵。

一級緩存：Session 級別的事務緩存

核心特性

• 生命週期：與 Session 綁定，Session 關閉即失效
• 作用域：線程私有，不同 Session 間不共享
• 自動管理：由 Hibernate 透明維護，無需手動配置
• 觸發操作：save()、get()、load()、update()、saveOrUpdate()、查詢接口

工作原理演示

Session session = HibernateUtil.getSession();
session.beginTransaction();

// 第一次查詢：發送 SQL
User user1 = (User) session.get(User.class, 1);
System.out.println("用戶名：" + user1.getName());
// 輸出：Hibernate: select ... from tb_user_info where id=?
//       用戶名：xqh

// 第二次查詢：直接從一級緩存獲取，無 SQL
User user2 = (User) session.get(User.class, 1);
System.out.println("用戶名：" + user2.getName());
// 輸出：用戶名：xqh (無 SQL 打印)

session.getTransaction().commit();
HibernateUtil.closeSession(session);

關鍵注意點

1. load() 可能返回代理對象，首次訪問非 ID 屬性時才查詢數據庫
2. get() 立即查詢並放入緩存
3. 同一 Session 內重複查詢同一實體，只會發送一次 SQL
4. 不同 Session 查詢同一實體，各自維護獨立緩存副本
5. 執行 session.clear() 或 session.evict(entity) 可手動清理

二級緩存：跨 Session 的進程級共享緩存

架構特點

• 插件化設計：需第三方緩存提供商 (Ehcache、Redis、Infinispan 等)
• 可配置策略：read-only、read-write、nonstrict-read-write、transactional
• 粒度控制：類級別、集合級別、查詢級別
• 生命週期：與 SessionFactory 同步，應用運行期間持續存在

整合 Ehcache 完整配置

1. 添加依賴

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-ehcache</artifactId>
    <version>5.4.x</version>
</dependency>
<dependency>
    <groupId>net.sf.ehcache</groupId>
    <artifactId>ehcache</artifactId>
    <version>2.10.x</version>
</dependency>

2. ehcache.xml 配置

<ehcache xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="ehcache.xsd"
         updateCheck="false" monitoring="autodetect">
    
    <diskStore path="java.io.tmpdir"/>
    
    <defaultCache 
        maxEntriesLocalHeap="10000"
        eternal="false"
        timeToIdleSeconds="120"
        timeToLiveSeconds="120"
        overflowToDisk="true"
        memoryStoreEvictionPolicy="LRU"/>
    
    <!-- 實體緩存配置 -->
    <cache name="com.xqh.model.User"
           maxEntriesLocalHeap="5000"
           eternal="false"
           timeToIdleSeconds="300"
           timeToLiveSeconds="600"
           overflowToDisk="true"/>
    
    <!-- 集合緩存配置 -->
    <cache name="com.xqh.model.User.orders"
           maxEntriesLocalHeap="2000"
           eternal="false"
           timeToIdleSeconds="300"
           timeToLiveSeconds="600"
           overflowToDisk="true"/>
    
    <!-- 查詢緩存配置 -->
    <cache name="org.hibernate.cache.internal.StandardQueryCache"
           maxEntriesLocalHeap="1000"
           eternal="false"
           timeToLiveSeconds="300"/>
    
    <cache name="org.hibernate.cache.spi.UpdateTimestampsCache"
           maxEntriesLocalHeap="5000"
           eternal="true"/>
</ehcache>

3. Hibernate 配置啟用二級緩存

<property name="hibernate.cache.use_second_level_cache">true</property>
<property name="hibernate.cache.region.factory_class">
    org.hibernate.cache.ehcache.EhCacheRegionFactory
</property>
<property name="hibernate.cache.use_query_cache">true</property>
<property name="hibernate.generate_statistics">true</property>

<!-- 實體緩存策略 -->
<class-cache class="com.xqh.model.User" usage="read-write"/>
<class-cache class="com.xqh.model.Order" usage="read-only"/>

<!-- 集合緩存策略 -->
<collection-cache collection="com.xqh.model.User.orders" usage="read-write"/>

4. 實體類註解配置 (JPA 風格)

@Entity
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
@org.hibernate.annotations.Cache(region = "com.xqh.model.User")
public class User {
    @Id @GeneratedValue
    private Long id;
    
    @OneToMany(mappedBy = "user")
    @Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
    private Set<Order> orders = new HashSet<>();
    // ...
}

二級緩存驗證測試

public class SecondLevelCacheTest {
    public static void main(String[] args) {
        // Session 1
        Session session1 = HibernateUtil.getSession();
        session1.beginTransaction();
        User user1 = (User) session1.get(User.class, 1L);
        System.out.println("Session1 查詢: " + user1.getName());
        session1.getTransaction().commit();
        session1.close(); // 一級緩存銷毀
        
        // Session 2 (新 Session)
        Session session2 = HibernateUtil.getSession();
        session2.beginTransaction();
        User user2 = (User) session2.get(User.class, 1L);
        System.out.println("Session2 查詢: " + user2.getName());
        session2.getTransaction().commit();
        session2.close();
        
        // 輸出結果：
        // Session1 查詢: Hibernate: select ... from user where id=?
        //                用戶名：xqh
        // Session2 查詢: 用戶名：xqh (無 SQL，命中二級緩存)
    }
}

查詢緩存：HQL/JPQL 結果集緩存

Query query = session.createQuery("FROM User WHERE name = :name");
query.setParameter("name", "xqh");
query.setCacheable(true); // 啟用查詢緩存
query.setCacheRegion("user.byName"); // 指定緩存區域
List<User> list = query.list();

緩存策略選擇指南

常見陷阱與最佳實踐

❌ 避坑指南

1. 盲目開啟所有實體緩存：頻繁變更的業務實體會導致緩存失效頻繁、鎖競爭
2. 忽略集合緩存配置：一對多關聯集合需單獨配置 <collection-cache>
3. 查詢緩存未同步更新：數據變更需調用 sessionFactory.getCache().evictQueryRegion()
4. 集群環境無分佈式緩存：單機 Ehcache 導致節點間數據不一致，需遷移至 Redis/Infinispan

✅ 最佳實踐

1. 分類管理：基礎數據 (字典、配置) 用 read-only；業務實體按變更頻率選擇策略
2. 監控指標：關注命中率、命中/未命中計數、緩存大小、淘汰數量
3. 預熱機制：應用啟動時預加載熱點數據
4. 版本字段：實體添加 @Version 支持樂觀鎖，配合 read-write 策略
5. 緩存穿透防護：查詢緩存為空時，短暫緩存空結果防止穿透 DB

分布式環境緩存方案對比

合理配置 Hibernate 緩存可將數據庫訪問減少 60%-90%，但關鍵在於「緩存什麼、如何失效、如何監控」。建議從只讀參考數據開始，逐步擴展到核心業務實體，並建立完善的緩存監控儀表板。