嵌套结果集映射优化

嵌套结果集映射是 MyBatis 处理关联查询的核心机制，理解其性能瓶颈和优化策略对复杂查询至关重要。

性能瓶颈分析

N+1 查询问题

嵌套查询（select 属性）方式加载关联数据时，会产生典型的 N+1 查询：

<resultMap id="blogWithAuthor" type="Blog">
  <id property="id" column="blog_id"/>
  <result property="title" column="title"/>
  <association property="author" column="author_id"
               select="selectAuthor" fetchType="LAZY"/>
</resultMap>

<select id="selectAuthor" resultType="Author">
  SELECT * FROM author WHERE id = #{id}
</select>

嵌套查询虽然配置简单，但数据量大时性能急剧下降。1000 条主数据关联 1000 次额外查询，延迟远超 JOIN 查询。

嵌套结果集内存占用

嵌套结果集映射会将 JOIN 结果全部加载到内存，大表 JOIN 时内存消耗显著：

<!-- 用户 1:N 订单 1:N 订单项，三层嵌套 -->
<resultMap id="userWithOrders" type="User">
  <id property="id" column="u_id"/>
  <collection property="orders" ofType="Order">
    <id property="id" column="o_id"/>
    <collection property="items" ofType="OrderItem">
      <id property="id" column="oi_id"/>
    </collection>
  </collection>
</resultMap>

三层嵌套 JOIN 的结果集行数为 用户数 × 平均订单数 × 平均订单项数，100 用户 × 50 订单 × 10 订单项 = 50,000 行，内存占用远超预期。

columnPrefix 多表别名隔离

问题场景

多次 JOIN 同一表时，列名冲突导致映射混乱：

SELECT u.id, u.name,
       a1.id AS author_id, a1.name AS author_name,
       a2.id AS editor_id, a2.name AS editor_name
FROM article u
LEFT JOIN author a1 ON u.author_id = a1.id
LEFT JOIN author a2 ON u.editor_id = a2.id

columnPrefix 解决方案

<resultMap id="articleWithAuthors" type="Article">
  <id property="id" column="id"/>
  <result property="title" column="title"/>
  <association property="author" resultMap="authorResult" columnPrefix="author_"/>
  <association property="editor" resultMap="authorResult" columnPrefix="editor_"/>
</resultMap>

<resultMap id="authorResult" type="Author">
  <id property="id" column="id"/>
  <result property="name" column="name"/>
  <result property="email" column="email"/>
</resultMap>

<select id="selectArticle" resultMap="articleWithAuthors">
  SELECT a.id, a.title,
         au1.id AS author_id, au1.name AS author_name, au1.email AS author_email,
         au2.id AS editor_id, au2.name AS editor_name, au2.email AS editor_email
  FROM article a
  LEFT JOIN author au1 ON a.author_id = au1.id
  LEFT JOIN author au2 ON a.editor_id = au2.id
  WHERE a.id = #{id}
</select>

columnPrefix 会在映射时为 resultMap 中的每个 column 自动添加前缀，解决同表多次 JOIN 的列名冲突问题。

columnPrefix 工作原理

1. MyBatis 读取 columnPrefix="author_" 配置。
2. 将 authorResult 中的 column="id" 映射为 author_id 列。
3. 将 column="name" 映射为 author_name 列。
4. 依次类推，自动完成前缀拼接和列定位。

嵌套结果集与嵌套查询对比

优化策略

策略一：按需选择映射方式

<!-- 高频访问：使用嵌套结果集，一次 JOIN -->
<resultMap id="orderWithUser" type="Order">
  <id property="id" column="order_id"/>
  <association property="user" javaType="User">
    <id property="id" column="user_id"/>
    <result property="name" column="user_name"/>
  </association>
</resultMap>

<!-- 低频访问：使用嵌套查询 + LAZY，按需加载 -->
<resultMap id="orderWithUserLazy" type="Order">
  <id property="id" column="order_id"/>
  <association property="user" column="user_id"
               select="selectUserById" fetchType="LAZY"/>
</resultMap>

策略二：合理控制 JOIN 层级

<!-- 避免：三层嵌套结果集，JOIN 膨胀 -->
<resultMap id="deepNested" type="Department">
  <collection property="employees" ofType="Employee">
    <collection property="projects" ofType="Project">
      <collection property="tasks" ofType="Task"/>
    </collection>
  </collection>
</resultMap>

<!-- 推荐：拆分为两次查询，避免过度 JOIN -->
<resultMap id="departmentWithEmployees" type="Department">
  <id property="id" column="dept_id"/>
  <collection property="employees" column="dept_id"
              select="selectEmployeesByDept" fetchType="LAZY"/>
</resultMap>

策略三：使用 columnPrefix 减少重复映射

<!-- 不推荐：重复定义 author 映射 -->
<resultMap id="articleResult" type="Article">
  <association property="author" javaType="Author">
    <id property="id" column="author_id"/>
    <result property="name" column="author_name"/>
    <result property="bio" column="author_bio"/>
  </association>
  <association property="reviewer" javaType="Author">
    <id property="id" column="reviewer_id"/>
    <result property="name" column="reviewer_name"/>
    <result property="bio" column="reviewer_bio"/>
  </association>
</resultMap>

<!-- 推荐：复用 resultMap + columnPrefix -->
<resultMap id="articleResult" type="Article">
  <association property="author" resultMap="authorResult" columnPrefix="author_"/>
  <association property="reviewer" resultMap="authorResult" columnPrefix="reviewer_"/>
</resultMap>

<resultMap id="authorResult" type="Author">
  <id property="id" column="id"/>
  <result property="name" column="name"/>
  <result property="bio" column="bio"/>
</resultMap>

策略四：分页 + 嵌套结果集的组合优化

<!-- 分页查询使用嵌套结果集时，先分页主表再关联查 -->
<select id="selectArticlesWithAuthor" resultMap="articleWithAuthor">
  SELECT a.id, a.title, a.content, a.author_id,
         au.id AS au_id, au.name AS au_name
  FROM (
    SELECT id, title, content, author_id
    FROM article
    ORDER BY create_time DESC
    LIMIT #{offset}, #{limit}
  ) a
  LEFT JOIN author au ON a.author_id = au.id
</select>

先对主表分页再 JOIN，避免 JOIN 后数据膨胀导致分页失效。

要点总结

• 嵌套结果集一次 JOIN，性能优于嵌套查询，但内存占用更高。
• columnPrefix 解决同表多次 JOIN 的列名冲突问题，复用 resultMap 减少重复配置。
• N+1 问题可通过 fetchType="LAZY" 缓解，但根除方案是改用嵌套结果集。
• 多层嵌套结果集会导致 JOIN 膨胀，建议拆分为多次查询。
• 分页场景应先对主表分页再 JOIN，避免数据膨胀影响分页准确性。
• 高频查询用嵌套结果集，低频按需加载用嵌套查询 + LAZY。