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 userWHERE 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 userWHERE 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，发送“后端”获取