一瓶辣酱1. MyBatis动态SQL的前世今生
作为一名长期使用MyBatis的开发者，我见证了动态SQL从最初的XML拼接发展到如今功能完备的标签体系。动态SQL本质上解决了传统JDBC开发中SQL语句硬编码的痛点——当业务需求变化时，我们需要不断修改Java代码中的SQL字符串，这种开发方式既低效又容易出错。
MyBatis通过OGNL表达式和一系列智能标签，将SQL的组装过程从Java代码转移到XML配置文件中。这种设计带来了三个显著优势：
- SQL与Java代码解耦，修改SQL不再需要重新编译部署
- 条件分支、循环等逻辑可以直接在XML中表达
- 自动处理参数类型转换和特殊字符转义
重要提示：虽然MyBatis提供了注解方式编写SQL，但复杂业务场景下XML配置方式仍然是首选，这也是为什么动态SQL标签体系如此重要。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心标签全解析与防注入机制
2.1 条件控制标签组
if标签是最基础的动态元素，它的test属性支持完整的OGNL表达式：
xml复制<select id="findActiveBlogWithTitleLike" resultType="Blog">
SELECT * FROM blog
WHERE state = 'ACTIVE'
<if test="title != null">
AND title like #{title}
</if>
</select>
choose/when/otherwise组合实现了Java中的switch-case逻辑：
xml复制<select id="findActiveBlogLike" resultType="Blog">
SELECT * FROM blog WHERE state = 'ACTIVE'
<choose>
<when test="title != null">
AND title like #{title}
</when>
<when test="author != null">
AND author_name like #{author}
</when>
<otherwise>
AND featured = 1
</otherwise>
</choose>
</select>
2.2 循环处理标签
foreach标签在处理IN条件时尤其强大，它能自动将集合展开为逗号分隔的列表：
xml复制<select id="selectPostIn" resultType="domain.blog.Post">
SELECT * FROM post
WHERE ID in
<foreach item="item" index="index" collection="list"
open="(" separator="," close=")">
#{item}
</foreach>
</select>
避坑指南：当传入空集合时，foreach会生成错误的SQL语法（如
WHERE id IN ()），建议配合if标签先判空：xml复制<if test="list != null and list.size() > 0"> ... </if>
2.3 智能拼接标签
where标签能智能处理WHERE子句：
- 自动删除开头的AND/OR
- 如果所有条件都不满足，不会生成WHERE关键字
xml复制<select id="findActiveBlogLike" resultType="Blog">
SELECT * FROM blog
<where>
<if test="state != null">
state = #{state}
</if>
<if test="title != null">
AND title like #{title}
</if>
</where>
</select>
set标签用于UPDATE语句，会自动剔除结尾的逗号：
xml复制<update id="updateAuthorIfNecessary">
update author
<set>
<if test="username != null">username=#{username},</if>
<if test="password != null">password=#{password},</if>
</set>
where id=#{id}
</update>
2.4 防注入原理剖析
MyBatis的防SQL注入机制基于预编译语句和参数绑定：
- 所有使用
#{}语法的地方都会被转换为JDBC的PreparedStatement参数 - 参数值会经过类型处理器(TypeHandler)进行安全转义
- 与字符串拼接(
${})方式对比：xml复制<!-- 安全方式 --> WHERE name = #{name} <!-- 危险方式（慎用） --> ORDER BY ${columnName}
实战经验：在表名、列名等需要动态指定的场景必须使用
${}时，务必在前端或服务层进行严格的输入校验和白名单过滤。
3. 高级用法与性能优化
3.1 动态SQL的复用策略
sql/include组合实现SQL片段复用：
xml复制<sql id="userColumns">
${alias}.id,${alias}.username,${alias}.password
</sql>
<select id="selectUsers" resultType="map">
select
<include refid="userColumns">
<property name="alias" value="t1"/>
</include>
from some_table t1
</select>
3.2 批量操作优化
使用foreach实现高效批量插入：
xml复制<insert id="insertBatch">
INSERT INTO user(name, age) VALUES
<foreach collection="list" item="item" separator=",">
(#{item.name}, #{item.age})
</foreach>
</insert>
性能提示：MySQL默认接受的最大SQL长度由max_allowed_packet参数控制（默认4MB），超大数据量需要分批次处理。
3.3 动态表名处理
通过参数指定表名（需注意SQL注入风险）：
xml复制<select id="queryFromTable" resultType="map">
SELECT * FROM ${tableName}
WHERE id = #{id}
</select>
4. 调试与问题排查
4.1 SQL日志打印配置
在mybatis-config.xml中开启完整SQL日志：
xml复制<configuration>
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
</configuration>
或使用Log4j2配置：
properties复制log4j.logger.org.mybatis=DEBUG
4.2 常见异常处理
参数为null导致的条件失效：
java复制// 错误做法：当name为null时，条件不会生效
userMapper.selectByCondition(name, age);
// 正确做法：使用包装对象或Map传参
Map<String, Object> params = new HashMap<>();
params.put("name", name);
params.put("age", age);
userMapper.selectByCondition(params);
类型转换异常：
xml复制<!-- 错误示例：OGNL将0视为false -->
<if test="status != null and status != '' and status != 0">
...
</if>
<!-- 正确做法：明确类型比较 -->
<if test="status != null and status != '' and status != '0'">
...
</if>
5. 实际开发中的经验总结
-
复杂条件处理：当条件逻辑非常复杂时，可以考虑：
- 使用
<script>标签编写多行SQL - 在Java代码中预先构建查询条件对象
- 使用MyBatis提供的Provider注解方式
- 使用
-
分页查询优化：
xml复制<select id="selectWithPage" resultType="User"> SELECT * FROM user <where> <if test="name != null"> name LIKE CONCAT('%',#{name},'%') </if> </where> LIMIT #{offset}, #{pageSize} </select> -
缓存与动态SQL：注意二级缓存与动态条件的配合问题，当同一个查询方法传入不同参数时，MyBatis可能会返回错误的缓存结果。解决方案：
- 为不同参数组合设置不同的cacheKey
- 在动态条件变化时手动清除缓存
- 对实时性要求高的查询关闭缓存
-
与MyBatis-Plus的配合：虽然MyBatis-Plus提供了强大的Wrapper条件构造器，但在复杂场景下，XML中的动态SQL仍然是更清晰的选择。两者可以混合使用：
java复制// Java代码中使用Wrapper构造基础条件 QueryWrapper<User> wrapper = new QueryWrapper<User>() .eq("dept_id", deptId); // XML中处理复杂逻辑 List<User> users = userMapper.selectComplexUsers(wrapper, otherParams); -
动态字段选择：通过
<choose>实现类似GraphQL的字段选择：xml复制<select id="selectWithFields" resultType="map"> SELECT id, <choose> <when test="fields.contains('name')">name,</when> <otherwise>NULL as name,</otherwise> </choose> <choose> <when test="fields.contains('email')">email</when> <otherwise>NULL as email</otherwise> </choose> FROM user </select>
在实际项目中，我发现动态SQL的最佳实践是：保持XML配置的简洁性，将过于复杂的业务逻辑放在Java代码中处理。同时，对高频使用的SQL片段进行充分复用，这样既能保证可维护性，又能获得MyBatis动态SQL的全部威力。