MyBatis：动态SQL高级标签使用方法指南

一、引言

目前互联网大厂在搭建后端Java服务时，常使用Springboot搭配Mybatis/Mybatis-plus的框架。Mybatis/Mybatis-plus之所以能成为当前国内主流的持久层框架，与其本身的优点有关：支持定制动态 SQL、存储过程及高级映射，简化数据库操作。

可能有人会问， 为什么要用动态SQL，在开发过程中把SQL写死不是比较方便、更加不容易出错吗？其实这是由开发过程中具体业务需求决定的，比如在用户注册场景下，用户注册填写信息时，会有必填字段和非必填字段，不同用户注册时传给后端的参数有区别，对应的插入用户表的SQL也不一样，因此，在这些的场景下开发人员需要使用动态SQL来完成。本文首先介绍Springboot项目中SQL映射方式，最后介绍动态SQL和支持动态SQL的核心标签。

欢迎关注工 众号：ItBeeCoder，查看更多高质量技术文章，发送“后端”获取资料 二、SQL映射方式

1、XML映射文件，该文件通常位于 resources/自定义的包路径/mapper 目录。

示例：

<!-- UserMapper.xml --> <mapper namespace="com.example.UserMapper"> <select id="selectUserById" resultType="User"> SELECT * FROM user WHERE id = #{id} </select> </mapper>

2、注解映射

适用场景：简单 SQL 可直接在接口方法上使用注解。

示例：

public interface UserMapper { @Insert("INSERT INTO user(name) VALUES(#{name})") @Options(useGeneratedKeys = true, keyProperty = "id") void insertUser(User user); } 欢迎关注工 众号：ItBeeCoder，查看更多高质量技术文章，发送“后端”获取资料 三、动态SQL及常用标签

在 MyBatis中，动态SQL允许开发人员根据不同的条件构建不同的 SQL 语句。执行原理为，使用OGNL从SQL参数对象中计算表达式的值，根据表达式的值动态拼接SQL，以此来完成动态SQL的功能。动态SQL中常用的核心标签有：、、、、、等。

1、动态 SQL 以下SQL为XML文件中复杂动态SQL的示例： <select id="searchUsers" resultType="User"> SELECT * FROM user <where> <if test="name != null"> AND name LIKE CONCAT('%', #{name}, '%') </if> <if test="roles != null"> AND role IN <foreach item="role" collection="roles" open="(" separator="," close=")"> #{role} </foreach> </if> </where> </select> 2、常用标签 1）<if> 标签

a）用途：条件判断，满足条件时包含 SQL 片段。

b）示例

<select id="findUser" resultType="User"> SELECT * FROM user WHERE 1=1 <if test="name != null"> AND name = #{name} </if> </select> 2）<where> 标签

a）用途：自动添加 WHERE 关键字，并去除首条多余的 AND/OR。

b）示例

<select id="selectByStudent" resultMap="BaseResultMap" parameterType="com.xxx.entity.Student"> select <include refid="Base_Column_List" /> from student <where> <if test="name != null and name !=''"> and name like concat('%', #{name}, '%') </if> <if test="sex != null"> and sex=#{sex} </if> </where> </select>

说明：以上SQL中，当条件都不满足时：此时 SQL 中应该要不能有 where ， 否则导致出错。当 if 有条件满足时：SQL 中需要有 where， 且第一个成立的 if 标签下的 and | or 等要去掉，这时候，我们可以使用 where 标签。

3）<set> 标签

a）用途：主要用于SQL的UPDATE命令中，自动添加 SET 关键字，并去除末尾多余的逗号。

b）示例：

<update id="updateUser"> UPDATE user <set> <if test="name != null">name = #{name},</if> <if test="age != null">age = #{age},</if> </set> WHERE id = #{id} </update> 4）<foreach> 标签

a）用途：遍历集合（如 IN 查询、批量插入）。

b）该标签的属性：

- collection：集合参数名。 - item：遍历元素的变量名。 - open/close：包裹结果的前缀/后缀。 - separator：元素间的分隔符。

c）示例：

<!-- IN 查询 --> SELECT * FROM user WHERE id IN <foreach item="id" collection="ids" open="(" separator="," close=")"> #{id} </foreach> <!-- 批量插入 --> INSERT INTO user (name) VALUES <foreach item="user" collection="list" separator=","> (#{user.name}) </foreach>

注意：在使用标签时，最好在标签前加上标签，判断列表是否为null或者有数据，如果列表没数据，不加标签直接使用标签会报错。第一个查询SQL的动态SQL建议写法：

SELECT * FROM user <if test = "ids != null and ids.size > 0"> WHERE id IN <foreach item="id" collection="ids" open="(" separator="," close=")"> #{id} </foreach> </if> 5）<choose>/<when>/<otherwise> 标签

a）用途：多条件分支（功能类似于switch-case）。

b）示例：

<select id="findUser" resultType="User"> SELECT * FROM user <where> <choose> <when test="name != null">AND name = #{name}</when> <when test="email != null">AND email = #{email}</when> <otherwise>AND is_active = 1</otherwise> </choose> </where> </select> 6）<trim> 标签

a）用途：自定义字符串修剪（可替代 标签 或 标签）。

b）属性：

- prefix：添加前缀。 - prefixOverrides：去除首部匹配的字符。 - suffix：添加后缀。 - suffixOverrides：去除尾部匹配的字符。

c）示例：

<!-- 替代 <where> --> <trim prefix="WHERE" prefixOverrides="AND |OR "> <if test="name != null and name != ``"> AND name = #{name} </if> </trim> <!-- 替代 <set> --> <trim prefix="SET" suffixOverrides=","> <if test="name != null">name = #{name},</if> </trim> 7）<bind> 标签

a）用途：创建变量并绑定到上下文，用于复杂表达式或重复逻辑。

b）示例：

<select id="searchUser"> <bind name="pattern" value="'%' + keyword + '%'" /> <!-- 拼接模糊查询参数 --> SELECT * FROM user WHERE name LIKE #{pattern} </select> 欢迎关注工 众号：ItBeeCoder，查看更多高质量技术文章，发送“后端”获取资料 四、使用注意事项

1）OGNL表达式中：test 属性中使用的表达式语言，支持复杂逻辑，例如：==, !=, &&, || 等操作。例如：

<if test="name != null and name != ''"> <!-- 同时检查非空和非空字符串 -->

2）参数处理：

mapper接口中抽象方法的集合参数需通过 @Param 命名 List<User> findUsersByIds(@Param("ids") List<Integer> ids); 空值检查需显式处理（如 test="name != null and name != ''"）。

3）动态 SQL 性能：避免写过度复杂的动态SQL，过度复杂的SQL可能影响数据库执行计划，导致查询性能差。

4）动态表名/列名不建议使用 ${}，建议使用#{}，以防止 SQL 注入。

5）在Springboot搭配使用Mybatis时，为了能将Mapper接口上加了@Mapper或@Dao的Bean注入到spring容器中，需要在启动类中添加@MapperScan注解，@MapperScan注解中的包路径名称为mapper接口的路径。如下所示：

@SpringBootApplication @MapperScan("com.example.mapper") public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); // 其它业务代码 } } 欢迎关注工 众号：ItBeeCoder，查看更多高质量技术文章，发送“后端”获取资料 五、一些最佳实践

1、在Mybatis的XML文件中对于某些频繁用到的SQL，为了避免重复写以及重复写导致的出错，可以引用某个常用的SQL，如下即为引用SQL的做法：

<sql id="all"> select * from user </sql> <select id="selectUserByUid" resultType="user"> <include refid="all"/> where uid = #{uid} </select> <select id="selectIf" resultType="user"> <include refid="all"/> <where> <if test="username != null"> username = #{username} </if> </where> </select>

2、判断list集合是否包含指定数据

<if test="list.contains('0')"> #{逻辑} </if>

3、XML的SQL中比较符号的写法

gt 对应 > gte 对应 >= lt 对应 <(会报错 相关联的 "test" 属性值不能包含 '<' 字符) lte 对应 <=(会报错 相关联的 "test" 属性值不能包含 '<' 字符) <![CDATA[ sql 语句 ]]> <![CDATA[ >= ]]>

4、MyBatis的XML中使用内部类的方式

内部类需要使用$符号连接，而不是点.，以下为正确写法：

com.xxx.model.SMSESBResult$ReceiveResult$ResultInfo 六、写在最后的话

总之，MyBatis的动态SQL功能允许开发者根据不同条件灵活构建SQL语句，避免手动拼接字符串，另外，常用查询列和查询SQL还可以借助动态SQL实现复用，提高XML中SQL代码的可维护性和安全性。

---

欢迎关注工 众号：ItBeeCoder，查看更多高质量技术文章，发送“后端”获取资料

又到了金三银四求职季，我整理了一些互联网大厂的面试题，有需要的可关注工 众号：ItBeeCoder，发送“后端”获取