MyBatis嵌套子查询动态SQL编写实践

最新推荐文章于 2026-04-17 09:33:14 发布
原创 最新推荐文章于 2026-04-17 09:33:14 发布 · 1.3k 阅读 · 21 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
标签
#mybatis #sql #数据库

MyBatis嵌套子查询动态SQL编写实践

在Java生态中，MyBatis作为一款优秀的ORM框架，广泛应用于数据库操作。其强大的动态SQL功能允许开发者根据业务需求灵活构建复杂的SQL语句，尤其是在处理嵌套子查询时，能够显著提升查询效率和代码可维护性。本文将深入探讨如何在MyBatis中编写嵌套子查询的动态SQL，并结合实际案例分析其应用场景与实现技巧。

一、MyBatis动态SQL的核心优势

1. 灵活性与可读性

MyBatis的动态SQL通过 <if>、<choose>、<when>、<foreach> 等标签，支持根据参数动态拼接SQL片段。相比传统字符串拼接方式，动态SQL更安全且易于维护。

2. 嵌套子查询的必要性

在复杂业务场景中，嵌套子查询常用于：

  • 分页查询：通过子查询限制结果集范围。
  • 多条件过滤：根据动态条件生成嵌套查询逻辑。
  • 数据聚合：结合子查询进行分组统计或关联查询。

二、嵌套子查询的动态SQL编写技巧

1. 基础语法与标签组合

MyBatis的嵌套子查询可以通过 <select> 标签的 resultMap 和 association/collection 实现，但在动态SQL中，更常见的是通过 <if> 和 <foreach> 标签直接拼接SQL语句。

（1）单层嵌套子查询

假设需要查询订单表（orders）中某个用户的所有订单，并筛选满足特定条件的订单项（order_items），可以编写如下动态SQL：

<select id="getOrdersByConditions" resultType="Order">
  SELECT * FROM orders
  WHERE user_id = #{userId}
  AND order_id IN (
    SELECT order_id FROM order_items
    <if test="status != null">
      WHERE status = #{status}
    </if>
  )
</select>
  • 解析：
    • 子查询部分通过 <if> 标签动态添加 status 条件。
    • 使用 #{} 参数绑定，避免SQL注入风险。
（2）多层嵌套子查询

对于更复杂的场景，例如查询用户订单中包含特定商品类别的订单项，可以嵌套多层子查询：

<select id="getOrdersByCategory" resultType="Order">
  SELECT * FROM orders
  WHERE order_id IN (
    SELECT order_id FROM order_items
    WHERE item_id IN (
      SELECT item_id FROM items
      <if test="category != null">
        WHERE category = #{category}
      </if>
    )
  )
</select>
  • 解析：
    • 通过多层嵌套子查询，逐层过滤数据。
    • 动态条件 category 的存在与否决定子查询的最终结果。

2. 动态子查询的高级用法

（1）动态IN条件

当需要根据传入的ID列表查询数据时，可以使用 <foreach> 标签：

<select id="getOrdersByIds" resultType="Order">
  SELECT * FROM orders
  WHERE order_id IN (
    SELECT id FROM order_items
    WHERE item_id IN
    <foreach item="id" collection="itemIds" open="(" separator="," close=")">
      #{id}
    </foreach>
  )
</select>
  • 解析：
    • <foreach> 标签将 itemIds 集合转换为 IN 条件。
    • 子查询中的 item_id 与外层 order_id 关联，实现多层过滤。
（2）动态AND/OFF条件拼接

在嵌套子查询中，动态拼接 AND 或 OR 条件需要特别注意语法合理性：

<select id="getOrdersWithComplexFilters" resultType="Order">
  SELECT * FROM orders
  WHERE user_id = #{userId}
  AND order_id IN (
    SELECT order_id FROM order_items
    <if test="status != null and status != ''">
      AND status = #{status}
    </if>
    <if test="minPrice != null">
      AND price >= #{minPrice}
    </if>
    <if test="maxPrice != null">
      AND price <= #{maxPrice}
    </if>
  )
</select>
  • 注意事项：
    • 子查询中的条件需确保逻辑正确性（如避免遗漏 WHERE 或多余 AND）。
    • 使用 <trim> 标签优化条件拼接：
      <trim prefix="WHERE" prefixOverrides="AND |OR ">
  <if test="status != null">
    status = #{status}
  </if>
  <if test="minPrice != null">
    AND price >= #{minPrice}
  </if>
</trim>
（3）动态JOIN与子查询结合

MyBatis支持在动态SQL中嵌入 JOIN 与子查询的组合：

<select id="getUserOrdersWithDetails" resultType="OrderDetail">
  SELECT o.*, i.item_name, i.price
  FROM orders o
  JOIN order_items i ON o.order_id = i.order_id
  WHERE o.user_id = #{userId}
  <if test="category != null">
    AND i.item_id IN (
      SELECT item_id FROM items
      WHERE category = #{category}
    )
  </if>
</select>
  • 解析：
    • 外层查询与子查询结合，实现数据关联。
    • 动态条件 category 控制子查询的执行。

三、嵌套子查询的实践场景

1. 分页查询优化

在分页场景中，嵌套子查询可以避免因多次查询导致的性能损耗。例如：

<select id="getOrdersWithPagination" resultType="Order">
  SELECT * FROM (
    SELECT *, ROW_NUMBER() OVER (ORDER BY create_time DESC) AS row_num
    FROM orders
    WHERE user_id = #{userId}
    <if test="status != null">
      AND status = #{status}
    </if>
  ) AS t
  WHERE row_num BETWEEN #{start} AND #{end}
</select>
  • 优势：
    • 通过子查询生成行号（ROW_NUMBER()），实现高效分页。
    • 动态条件支持灵活过滤。

2. 多条件聚合统计

统计用户订单总金额时，结合子查询与动态条件：

<select id="getTotalAmount" resultType="map">
  SELECT SUM(total_amount) AS total
  FROM (
    SELECT order_id, SUM(price * quantity) AS total_amount
    FROM order_items
    WHERE 1=1
    <if test="userId != null">
      AND order_id IN (
        SELECT order_id FROM orders WHERE user_id = #{userId}
      )
    </if>
    <if test="status != null">
      AND status = #{status}
    </if>
    GROUP BY order_id
  ) AS subquery
</select>
  • 解析：
    • 子查询计算每个订单的总金额。
    • 外层查询汇总所有订单的总金额。

四、嵌套子查询的常见问题与解决方案

1. SQL注入风险

动态SQL若未正确使用参数绑定（如 #{}），可能导致SQL注入。例如：

<!-- 错误示例：直接拼接参数 -->
<if test="category != null">
  AND category = '${category}'
</if>

解决方案：
始终使用 #{} 进行参数绑定，避免直接拼接字符串。

2. 性能优化

嵌套子查询可能因层级过深导致执行效率低下。
优化建议：

  • 减少嵌套层级：优先使用JOIN代替多层子查询。
  • 索引优化：为子查询涉及的字段添加索引。
  • 分页优化：避免在子查询中使用 LIMIT，优先在外层控制。

3. 调试与日志分析

动态SQL的调试可能因条件拼接复杂而变得困难。
调试技巧：

  • 启用MyBatis日志：配置 log4j 或 SLF4J 输出SQL语句。
  • 使用 <bind> 标签：预定义变量简化调试：
    <bind name="dynamicWhere" value="@org.apache.ibatis.jdbc.StringUtils@sqlWhereClause(criteria)"/>

五、完整案例：动态嵌套子查询实现分页与筛选

1. 需求背景

查询某用户的订单，支持按商品类别、订单状态和价格区间筛选，并实现分页功能。

2. MyBatis XML映射文件

<select id="searchOrders" parameterType="map" resultType="Order">
  SELECT * FROM (
    SELECT o.*, 
           SUM(i.price * i.quantity) AS total_amount
    FROM orders o
    JOIN order_items i ON o.order_id = i.order_id
    <if test="userId != null">
      AND o.user_id = #{userId}
    </if>
    <if test="category != null">
      AND i.item_id IN (
        SELECT item_id FROM items
        WHERE category = #{category}
      )
    </if>
    <if test="status != null">
      AND o.status = #{status}
    </if>
    <if test="minPrice != null">
      AND i.price >= #{minPrice}
    </if>
    <if test="maxPrice != null">
      AND i.price <= #{maxPrice}
    </if>
    GROUP BY o.order_id
  ) AS t
  ORDER BY create_time DESC
  LIMIT #{offset}, #{pageSize}
</select>
  • 关键点：
    • 外层子查询计算订单总金额。
    • 多个 <if> 标签动态拼接过滤条件。
    • 分页通过 LIMIT 实现。

3. Java代码调用

public interface OrderMapper {
  List<Order> searchOrders(@Param("userId") Long userId,
                             @Param("category") String category,
                             @Param("status") String status,
                             @Param("minPrice") BigDecimal minPrice,
                             @Param("maxPrice") BigDecimal maxPrice,
                             @Param("offset") int offset,
                             @Param("pageSize") int pageSize);
}
  • 调用示例：
    Map<String, Object> params = new HashMap<>();
params.put("userId", 123L);
params.put("category", "电子产品");
params.put("offset", 0);
params.put("pageSize", 10);
List<Order> orders = orderMapper.searchOrders(params);

六、总结与最佳实践

1. 核心要点

  • 动态条件拼接：通过 <if>、<foreach> 等标签构建灵活的嵌套子查询。
  • 性能优先：合理设计SQL结构，避免不必要的嵌套。
  • 安全性：始终使用 #{} 绑定参数，防止SQL注入。

2. 最佳实践

  • 模块化SQL：将常用子查询封装为 <sql> 片段复用。
  • 注释与格式化：在XML中添加注释，提升可读性。
  • 单元测试：针对不同参数组合编写测试用例，确保逻辑正确性。

3. 扩展学习

  • MyBatis Plus：结合MyBatis Plus的 QueryWrapper 简化动态查询。
  • SQL优化工具：使用 EXPLAIN 分析查询计划，进一步优化性能。

七、参考资料

  • MyBatis官方文档：https://mybatis.org/mybatis-3/zh/index.html
  • SQL性能优化指南：《高性能MySQL》第三版
  • MyBatis动态SQL实践案例：https://github.com/mybatis/mybatis-3

通过以上实践，开发者可以高效利用MyBatis的动态SQL功能，灵活应对复杂查询需求，同时保证代码的可读性与安全性。

Mybatis框架（子查询）
06-30
Mybatis框架（子查询）
mybatis一对多结果集,主表分页查询,子表条件查询
学海无涯,我用JAVA
07-28 3184
一对多查询嵌套查询: 主表查询过程中,再次调用一个查询,取查询子表数据嵌套结果集查询: 一次性查询主表关联出子表,通过结果集封装,将自己封装为一个集合,返回一个一对多的结果今天要说的是当: 做了一对多查询后,还要对多的子表,进行条件过滤,然后在反过来应用到主表上,继续分页查询~~丧心病狂的产品汪~~至此,一个一对多,然后用子表的过滤条件,作用到主表上的 分页…已经实现了~~
使用mybatisPlus的queryWrapper进行子查询(以及传统xml方式做leftjoin)
weixin_42759398的博客
05-05 2万+
然后，我们通过 `checkGroupMapper.selectList` 方法，根据检查套餐与检查组之间的关系表（t_setmeal_checkgroup） 查询所有关联的检查组对象 `groupList`，并通过循环遍历每个检查组对象，再通过 `checkItemMapper.selectList` 方法，根据检查组与检查项之间的关系表（t_checkgroup_checkitem）查询所有关联的检查项对象，然后将检查项列表设置到检查组对象中，最后将检查组列表设置到检查套餐对象中，并返回它。
Mybatis 子查询
Kiss_forever的博客
04-07 8757
子查询： 同表中子查询直接在statement中写，和sql格式一样； 不同表间的子查询通过resultMap来实现： <resultMap type = "Book" id = "BookAndReader" autoMapping = "true"> <id colume = "id" property = "id"/> <association property = "reader" javaType = "Reader" autoMapping = "t
mybatis子查询
qq_43960768的博客
01-05 8914
mybatis子查询
Mybatis 嵌套子查询动态SQL编写
zhenyu333的博客
05-16 519
在MyBatis中，嵌套子查询的动态SQL参数传递问题可以通过在主查询中将参数作为常量列传递到子查询中来解决。具体实现方式是在主查询的SELECT语句中，将需要传递给子查询的参数作为常量列，并赋予别名。这些别名随后可以在子查询中作为动态SQL的参数使用。
MyBatis-Plus Samples条件构造器深度解析：告别复杂SQL编写
最新发布
gitblog_00816的博客
04-17 818
MyBatis-Plus Samples是MyBatis-Plus官方提供的示例项目，其中条件构造器（Wrapper）是简化SQL编写的核心功能之一。本文将通过MyBatis-Plus Samples中的实际案例，带你快速掌握条件构造器的使用技巧，让你从此告别繁琐的SQL语句编写。 ## 什么是MyBatis-Plus条件构造器？ 条件构造器是MyBatis-Plus提供的一种面向对象的查询条
Mybatis的嵌套查询-column多条件
Choleen的博客
07-23 695
嵌套查询，即是上层的查询结果可以作为下层的查询条件。在关联查询中也是一样，left join后面也是有条件关联。在column字段中，它是一个set集合。如下</
Java学习笔记10-2——MyBatis
weixin_44238066的博客
02-25 1108
Mybatis（2）
mybatis xml多表查询，子查询，连接查询，动态sql
weixin_57689217的博客
01-19 2804
【代码】mybatis xml多表查询，子查询，连接查询，动态sql。
在 MyBatis 中进行一对多的连表子查询
李长渊的博客
08-26 1138
在 MyBatis 中进行一对多的连表子查询
mybatis中的if-else的嵌套使用
舒克日记的博客
04-23 8282
mybatis的if-else的嵌套使用方法 案例一：if-else 在mybatis的使用过程中，难免会存在使用if-else的逻辑，但是实际是没有这种语法的，提供了choose标签来替代这种语法 <select id="selectUserByState" resultType="com.bz.model.entity.User"> SELECT * FROM user WHERE 1=1 <choose>
MyBatis子查询
weixin_30827565的博客
03-10 411
一、父查询BaseChildResultMap： <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" > ...
MyBatis中if和choose的嵌套
txd2016_5_11的博客
11-05 1万+
上代码： &lt;!-- public List&lt;VadtaxShow&gt; findList(VadtaxShow vadtaxShow); --&gt; &lt;select id="findList" parameterType="com.cdqyzj_WC.Backstage.vaddedtax.domain.VaddeTax" resultType="com.cdqyzj...
【Mybatis】子查询总结（一对多Collection），查询父对象时，也查询子对象；
陶洲川的博客
12-15 6972
一、需求比如，我们有两个对象，一个问答，一个评论，类似百度知道一样的东西；我们查询一个问答的时候，可以查看其下面的评论； 我在查询J_questionandanswer这张表的时候，需要查询j_comment这张表，并把j_comment这张表里的数据放到questionAndAnswer这个实体中；操作步骤如下：二、解决办法准备工作： 1、j_comment表的创建； 2、comment的实
Spring boot mybatis 子查询
阿友的专栏
09-07 2039
Spring boot mybatis 子查询 需求： 一对多的两张表数据，主表的唯一id在副表对应多个数据 主表：acloth_class 字段：id, name, status, pid 副表：acloth_class_content 字段：id，class_id(主表id)，class_name 流程： 表的实体类 mapper类 xml Service接口和ServiceImpl实现类 接口 步骤一：表的实体类： AClothClassContent.java package com.examp
mybatis中的if-else使用及if嵌套使用
热门推荐
qq_43040552的博客
03-09 4万+
在使用mybatismapper动态sql中if-else的使用
SQL子查询与MyBatis映射
二哈喇子！
01-23 1692
子查询，mybatis映射
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

酷爱码

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值