mybatis通过<if>、<where>、<set>、<foreach>和<choose>等标签实现动态sql，支持条件查询、分支选择、集合遍历和字段更新，自动处理关键字与语法错误，避免sql注入，提升开发效率。
MyBatis 的强大之处在于它支持动态 SQL，能够根据不同的条件拼接 SQL 语句，避免拼接字符串的麻烦和潜在的 SQL 注入风险。在实际开发中，查询条件往往是可变的，比如用户可能只填了部分搜索项，这时就需要动态地构建 WHERE 条件。
1. 使用 <where> 和 <if> 构建条件查询
最常见的动态 SQL 场景是带条件的 select 查询。MyBatis 提供了 <if> 标签来判断某个参数是否有效，并结合 <where> 自动处理 AND 或 OR 的开头问题。
示例：根据用户名和年龄可选条件查询用户
<select id="findUsers" parameterType="map" resultType="User"> 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> </select>
说明：
– test 属性 中写的是 OGNL 表达式，用于判断参数是否满足条件。
– <where> 会自动去除第一个多余的 AND 或 OR，避免语法错误。
2. 使用 <choose>、<when>、<otherwise> 实现分支逻辑
类似于 Java 中的 switch-case，<choose> 可以实现多个互斥条件中的一个生效。
<select id="findUserByStrategy" parameterType="map" resultType="User"> 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> </select>
这个例子中，只会使用 id、name 或默认条件之一，适合“优先级选择”类场景。
立即学习“Java免费学习笔记（深入）”；
3. 使用 <foreach> 处理集合遍历（如 IN 查询）
当需要对集合或数组进行遍历（比如 IN 查询），可以使用 <foreach> 标签。
<select id="findUsersByIds" parameterType="list" resultType="User"> SELECT id, name, age FROM users WHERE id IN <foreach item="id" index="index" Collection="list" open="(" separator="," close=")"> #{id} </foreach> </select>
说明：
– collection 指定传入的集合类型（List、Array 等）。
– item 是循环中每个元素的别名。
– open 和 close 定义包裹符号，separator 是分隔符。
4. 使用 <set> 动态更新字段
在 UPDATE 语句中，<set> 可以自动添加 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. 使用 <trim> 自定义前缀/后缀处理
<trim> 是更灵活的标签，可以替代 <where> 和 <set>。
例如，自定义 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 正确引用即可。