萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MyBatis 延遲加載深度解析:原理、配置、代理機制與 aggressiveLazyLoading 陷阱

MyBatis 延遲加載針對嵌套查詢 (<collection>, <association>) 實現按需加載關聯數據。本文從配置方式、源碼級代理機制、aggressiveLazyLoading 預設行為陷阱、觸發條件自定義等維度深度解析。

兩種啟用方式

1. 映射級獨立配置

<resultMap id="BaseResultMap" type="com.example.SysWfProcess">
  <id column="id" property="id"/>
  <collection property="nodes" column="id" 
    ofType="com.example.SysWfNode" select="selectNodes" fetchType="lazy"/>
</resultMap>

優先級最高,覆蓋全域設定。

2. 全域配置 (mybatis-config.xml)

<settings>
  <setting name="lazyLoadingEnabled" value="true"/>
</settings>

特定關聯需即時加載時,設定 fetchType="eager" 覆蓋。

核心原理:動態代理攔截

DefaultResultSetHandler.createResultObject() 流程:

  1. 建立實體對象實例
  2. 檢測 ResultMapping 中是否有 nestedQueryId != null && isLazy()
  3. 是 → ProxyFactory.createProxy() 建立實體對象的代理 (而非屬性代理)
  4. 返回代理對象給調用方

預設代理工廠:JavassistProxyFactory (需 javassist 依賴),可切換 CGLIB:

<setting name="proxyFactory" value="CGLIB"/>

關鍵陷阱:aggressiveLazyLoading 預設為 true

預設行為:首次調用代理對象的任意方法 (包括 toString(), equals(), hashCode()) 即觸發所有延遲屬性加載。

// 測試代碼
SysWfProcess process = mapper.selectByPrimaryKey(1);
System.out.println(process.getClass()); // 僅打印類名,但觸發了 nodes 集合加載!

日誌顯示執行了兩條 SQL:主查詢 + 關聯查詢。這違背了「按需加載」初衷。

解決方案:關閉 aggressiveLazyLoading

<settings>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="aggressiveLazyLoading" value="false"/>
</settings>

效果:僅在首次訪問具體延遲屬性時 (如 process.getNodes()) 觸發該屬性加載,其他屬性保持未加載 (null)。

自定義觸發方法:lazyLoadTriggerMethods

關閉 aggressiveLazyLoading 後,仍可指定特定方法觸發全量加載:

<setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/> 

預設即為這四個方法。可擴展如 init,loadAll 等業務方法。

代理攔截器源碼邏輯 (Javassist 版)

public Object invoke(Object enhanced, Method method, Method methodProxy, Object[] args) {
    String methodName = method.getName();
    if (WRITE_REPLACE_METHOD.equals(methodName)) { /* 序列化處理 */ }
    else {
        if (lazyLoader.size() > 0 && !FINALIZE_METHOD.equals(methodName)) {
            if (aggressive || lazyLoadTriggerMethods.contains(methodName)) {
                lazyLoader.loadAll(); // 全量加載
            } else if (PropertyNamer.isProperty(methodName)) {
                String property = PropertyNamer.methodToProperty(methodName); // getNodes -> nodes
                if (lazyLoader.hasLoader(property)) {
                    lazyLoader.load(property); // 單屬性加載
                }
            }
        }
    }
    return methodProxy.invoke(enhanced, args);
}

關鍵點:攔截發生在目標方法執行前,保證屬性已加載再執行業務邏輯。

最佳實踐建議

  • 生產環境建議:lazyLoadingEnabled=true, aggressiveLazyLoading=false
  • 明確業務邊界:哪些關聯是高頻必需 (設 eager),哪些是低頻可選 (設 lazy)
  • 避免在 toString()、日誌輸出中直接引用實體對象,誤觸發全量加載
  • 大集合關聯慎用延遲加載,N+1 問題風險大,考慮 JOIN 查詢或批次預加載

理解代理機制與預設行為,才能真正駕馭 MyBatis 延遲加載,避免「以為延遲了,實則全載了」的效能陷阱。

copyright © 萬盛學電腦網 all rights reserved