MyBatis动态SQL原理与电商系统实战应用

1. MyBatis动态SQL的核心价值解析

在数据库操作中，我们经常遇到需要根据不同条件拼接SQL语句的场景。传统JDBC开发中，这种需求往往导致大量字符串拼接和条件判断代码，不仅难以维护，还存在SQL注入风险。MyBatis的动态SQL功能正是为解决这些问题而生。

我曾在电商系统中处理过一个典型场景：商品列表查询需要支持多达12个可选筛选条件（价格区间、品牌、分类、库存状态等）。如果采用传统方式，仅这一个查询就需要编写近200行Java代码来拼接SQL。而改用MyBatis动态SQL后，XML映射文件中的配置仅需50行左右，且逻辑清晰可见。

动态SQL的核心优势在于：

• 条件逻辑与Java代码解耦
• 自动处理参数类型转换
• 内置防SQL注入机制
• 支持灵活的表达式语言

2. 动态SQL元素深度剖析

2.1 if元素：条件分支的基础构建块

<if>是最常用的动态SQL元素，其test属性支持OGNL表达式。在实际项目中，我发现几个关键实践要点：

xml复制<select id="findProducts" resultType="Product">
  SELECT * FROM products
  WHERE status = 'ACTIVE'
  <if test="minPrice != null">
    AND price >= #{minPrice}
  </if>
  <if test="maxPrice != null">
    AND price &lt;= #{maxPrice}
  </if>
</select>

注意：XML中特殊字符如<需要转义，或者使用CDATA区块包裹SQL

2.2 choose/when/otherwise：SQL版的switch-case

当需要实现多选一逻辑时，choose系列元素比多个if更清晰：

xml复制<select id="searchUsers" resultType="User">
  SELECT * FROM users
  WHERE
  <choose>
    <when test="id != null">
      id = #{id}
    </when>
    <when test="email != null">
      email = #{email}
    </when>
    <otherwise>
      username = #{username}
    </otherwise>
  </choose>
</select>

2.3 where/set/trim：智能处理SQL语法

这些包装元素能自动处理前缀/后缀问题，是动态SQL的"语法糖"：

xml复制<select id="findComplex" resultType="Item">
  SELECT * FROM items
  <where>
    <if test="category != null">
      category_id = #{category}
    </if>
    <if test="name != null">
      AND name LIKE CONCAT('%',#{name},'%')
    </if>
  </where>
</select>

实操技巧：where元素会自动去除开头的AND/OR，但不会处理结尾的。对于复杂条件，建议结合trim使用

3. 高级动态SQL技巧实战

3.1 foreach：处理集合参数的利器

批量操作是foreach的典型场景，注意区分list和array的写法差异：

xml复制<insert id="batchInsert">
  INSERT INTO users(name, email) VALUES
  <foreach item="user" collection="list" separator=",">
    (#{user.name}, #{user.email})
  </foreach>
</insert>

<select id="findByIds" resultType="User">
  SELECT * FROM users
  WHERE id IN
  <foreach item="id" collection="array" open="(" separator="," close=")">
    #{id}
  </foreach>
</select>

3.2 bind：创建可重用变量

bind元素可以在SQL执行前创建变量，特别适合需要重复使用的表达式：

xml复制<select id="search" resultType="Blog">
  <bind name="pattern" value="'%' + keyword + '%'" />
  SELECT * FROM blog
  WHERE 
    title LIKE #{pattern}
    OR content LIKE #{pattern}
</select>

3.3 script：注解中的动态SQL

在Mapper接口中使用@Select等注解时，可以用script标签嵌入动态SQL：

java复制@Update({
  "<script>",
  "UPDATE user",
  "  <set>",
  "    <if test='name != null'>name=#{name},</if>",
  "    <if test='email != null'>email=#{email},</if>",
  "  </set>",
  "WHERE id=#{id}",
  "</script>"
})
void updateUserSelective(User user);

4. 性能优化与避坑指南

4.1 动态SQL的性能陷阱

1. 过度动态化问题：我曾优化过一个查询，原本5个固定条件被拆分成15个if判断，导致执行计划缓存效率低下。解决方案是：

   • 对高频查询保持相对稳定的结构
   • 将强相关条件组合在一起

2. 集合参数大小控制：foreach处理大集合（>1000）时：

   • 考虑分批处理
   • 数据库层面设置in条件上限
   • 使用临时表替代in查询

4.2 最佳实践总结

1. XML格式化规范：

   • 每个动态元素独立一行
   • 嵌套不超过3层
   • 复杂逻辑添加注释

2. 测试覆盖率要点：

   • 验证所有条件分支
   • 检查null/空集合边界情况
   • 监控生成的SQL语句

3. 安全注意事项：

   • 禁止在test表达式中使用${}
   • 字符串比较使用equals而非==
   • 数值比较注意类型转换

5. 真实案例：电商搜索功能实现

以下是我在电商平台项目中实现的商品搜索SQL：

xml复制<select id="searchProducts" resultMap="productResultMap">
  SELECT p.*, c.name as category_name 
  FROM products p
  JOIN categories c ON p.category_id = c.id
  <where>
    <if test="params.keyword != null">
      AND (p.name LIKE CONCAT('%',#{params.keyword},'%') 
           OR p.description LIKE CONCAT('%',#{params.keyword},'%'))
    </if>
    <if test="params.categoryId != null">
      AND p.category_id = #{params.categoryId}
    </if>
    <if test="params.minPrice != null">
      AND p.price >= #{params.minPrice}
    </if>
    <if test="params.maxPrice != null">
      AND p.price &lt;= #{params.maxPrice}
    </if>
    <if test="params.brandIds != null and params.brandIds.size() > 0">
      AND p.brand_id IN
      <foreach item="brandId" collection="params.brandIds" 
               open="(" separator="," close=")">
        #{brandId}
      </foreach>
    </if>
    <if test="params.hasStock == true">
      AND p.stock > 0
    </if>
  </where>
  <choose>
    <when test="params.sortBy == 'price_asc'">
      ORDER BY p.price ASC
    </when>
    <when test="params.sortBy == 'price_desc'">
      ORDER BY p.price DESC
    </when>
    <otherwise>
      ORDER BY p.create_time DESC
    </otherwise>
  </choose>
</select>

这个实现支持：

• 关键词搜索（名称/描述）
• 多条件筛选（分类、价格区间、品牌）
• 库存过滤
• 多种排序方式

在实际运行中，通过MyBatis日志可以看到生成的SQL会根据参数动态变化，例如当只传keyword时，WHERE子句只有关键词条件；当传了brandIds数组时，会自动生成IN语句。