当前位置：首页 > 文章列表 > 文章 > java教程 > MyBatis动态SQL使用与配置全解析

MyBatis动态SQL使用与配置全解析

2026-02-08 21:53:39 0浏览收藏

从现在开始，努力学习吧！本文《MyBatis动态SQL怎么用及配置详解》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

MyBatis通过、、、和等标签实现动态SQL，支持条件查询、分支选择、集合遍历和字段更新，自动处理关键字与语法错误，避免SQL注入，提升开发效率。

java怎么用MyBatis实现动态SQL 学习MyBatis动态SQL语法与配置

MyBatis 的强大之处在于它支持动态 SQL，能够根据不同的条件拼接 SQL 语句，避免拼接字符串的麻烦和潜在的 SQL 注入风险。在实际开发中，查询条件往往是可变的，比如用户可能只填了部分搜索项，这时就需要动态地构建 WHERE 条件。

1. 使用和构建条件查询

最常见的动态 SQL 场景是带条件的 SELECT 查询。MyBatis 提供了标签来判断某个参数是否有效，并结合自动处理 AND 或 OR 的开头问题。

示例：根据用户名和年龄可选条件查询用户

&lt;select id=&quot;findUsers&quot; parameterType=&quot;map&quot; resultType=&quot;User&quot;&gt;
  SELECT id, name, age, email FROM users
  <where>
    <if test="name != null and name != ''">
      AND name LIKE CONCAT('%', #{name}, '%')
    </if>
    <if test="age != null">
      AND age >= #{age}
    </if>
  </where>
&lt;/select&gt;

说明：
- test 属性 中写的是 OGNL 表达式，用于判断参数是否满足条件。
- 会自动去除第一个多余的 AND 或 OR，避免语法错误。

2. 使用、、实现分支逻辑

类似于 Java 中的 switch-case，可以实现多个互斥条件中的一个生效。

&lt;select id=&quot;findUserByStrategy&quot; parameterType=&quot;map&quot; resultType=&quot;User&quot;&gt;
  SELECT id, name, age FROM users
  <where>
    <choose>
      <when test="id != null">
        id = #{id}
      </when>
      <when test="name != null">
        name LIKE CONCAT('%', #{name}, '%')
      </when>
      <otherwise>
        age > 18
      </otherwise>
    </choose>
  </where>
&lt;/select&gt;

这个例子中，只会使用 id、name 或默认条件之一，适合“优先级选择”类场景。

3. 使用处理集合遍历（如 IN 查询）

当需要对集合或数组进行遍历（比如 IN 查询），可以使用标签。

&lt;select id=&quot;findUsersByIds&quot; parameterType=&quot;list&quot; resultType=&quot;User&quot;&gt;
  SELECT id, name, age FROM users
  WHERE id IN
  <foreach item="id" index="index" collection="list"
           open="(" separator="," close=")">
    #{id}
  </foreach>
&lt;/select&gt;

说明：
- collection 指定传入的集合类型（List、Array 等）。
- item 是循环中每个元素的别名。
- open 和 close 定义包裹符号，separator 是分隔符。

4. 使用动态更新字段

在 UPDATE 语句中，可以自动添加 SET 关键字并去除末尾多余的逗号。

<update id="updateUser" parameterType="User">
  UPDATE users
  <set>
    <if test="name != null">name = #{name},</if>
    <if test="age != null">age = #{age},</if>
    <if test="email != null">email = #{email}</if>
  </set>
  WHERE id = #{id}
</update>

这样即使某些字段为空，也不会影响 SQL 的正确性。

5. 使用自定义前缀/后缀处理

是更灵活的标签，可以替代和。

例如，自定义 where 逻辑：

<trim prefix="WHERE" prefixOverrides="AND |OR ">
  <if test="name != null">AND name = #{name}</if>
  <if test="age != null">OR age = #{age}</if>
</trim>

prefix 表示添加前缀，prefixOverrides 表示去除开头的指定内容。

基本上就这些常用语法。掌握 if、where、set、foreach、choose 这几个标签，就能应对大多数动态 SQL 场景。关键是理解 test 判断条件的写法和参数传递方式（Map、对象、List 等）。配置上无需额外设置，只要 Mapper XML 正确引用即可。

理论要掌握，实操不能落！以上关于《MyBatis动态SQL使用与配置全解析》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！