MyBatis resultType 與 resultMap 差異實戰對比

核心差異速覽

實戰對比：同一查詢，兩種寫法

場景：Goods 表欄位含下劃線，Java 屬性駝峰

-- 表結構
id, cate_id, name, price, description, order_no, update_time

寫法一：resultType + 別名/駝峰開關

<select id="selectById" resultType="goods">
  SELECT 
    id, 
    cate_id AS cateId, 
    name, 
    price, 
    description, 
    order_no AS orderNo, 
    update_time AS updateTime
  FROM goods WHERE id = #{id}
</select>

或開啟全局 mapUnderscoreToCamelCase=true，SQL 可直寫列名。

寫法二：resultMap 顯式映射

<resultMap id="goodsMap" type="Goods">
  <id property="id" column="id"/>
  <result property="cateId" column="cate_id"/>
  <result property="name" column="name"/>
  <result property="price" column="price"/>
  <result property="description" column="description"/>
  <result property="orderNo" column="order_no"/>
  <result property="updateTime" column="update_time"/>
</resultMap>

<select id="selectAll" resultMap="goodsMap">
  SELECT id, cate_id, name, price, description, order_no, update_time FROM goods
</select>

輸出差異演示

// resultType 結果（未開啟駝峰、無別名時）
[goods include:Id=4,name=clark,orderNo=null,cateId=null,updateTime=null]

// resultMap 結果
[goods include:Id=4,name=clark,orderNo=5,cateId=12,updateTime=2024-01-15]

resultType 依賴「列名精確匹配屬性名」，缺一不可；resultMap 逐欄位聲明，零遺漏。

何時必須用 resultMap

1. 多表關聯：一對一 <association>、一對多 <collection>
2. 主鍵非 id / 聯合主鍵：需 <id> 標識正確列
3. 列名與屬性名差異大：手寫映射比 SQL 別名更清晰
4. 二級緩存/嵌套結果去重：依賴 <id> 唯一標識
5. 構造器注入/Builder 模式：<constructor> 映射

最佳實踐建議

• 簡單單表、列名規範 → resultType（開啟駝峰轉換）
• 複雜映射、關聯查詢、緩存場景 → resultMap
• 團隊規範：統一用 resultMap 避免隱性 Bug，IDE 可自動生成骨架

總結

resultType 是「約定優於配置」的便捷門面，resultMap 是「配置優於約定」的精準手術刀。理解自動映射的匹配規則與顯式映射的控制力，能根據場景做最優選擇。