一、引言
目前互联网大厂在搭建后端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，发送“后端”获取
