MyBatis 支持动态 SQL 吗？

2026年01月07日

面试考察点

面试官提出这个问题，通常希望考察以下几个层面，而不仅仅是一个简单的 “是” 或 “否”：

基础概念掌握：面试官首先想确认你是否了解 MyBatis 框架的核心特性之一，即其对动态 SQL 的支持。
实际应用能力：更进一步，面试官想知道你是否在项目中有实际使用经验，能否列举出常用的动态 SQL 元素，并说明它们分别解决了什么样的业务场景问题（例如条件查询、批量操作、避免 WHERE 1=1 等）。
原理与理解深度：通过此问题，面试官可能引导你阐述动态 SQL 的工作原理（基于 OGNL 表达式和 XML/注解解析），以及它与纯字符串拼接方式相比的优势（如可读性、维护性、防 SQL 注入）。
最佳实践与避坑：有经验的面试官会期待你分享在使用动态 SQL 时的一些最佳实践或常见陷阱，例如 <if> 标签中 test 表达式的写法、使用 <where> 和 <set> 标签的好处、以及在复杂动态 SQL 中如何保持可读性。

核心答案

是的，MyBatis 非常出色地支持动态 SQL，这甚至是它相较于其他 ORM 框架（如 Hibernate 的 HQL/JPA Criteria）的一大特色和优势。它允许我们在映射文件的 SQL 语句中，根据运行时的条件（参数值）来动态地拼接 SQL 片段，从而构建出灵活、强大的 SQL 语句。

深度解析

原理/机制

MyBatis 的动态 SQL 功能本质上是一个基于 OGNL（Object-Graph Navigation Language）表达式的 SQL 模板语言处理器。

在 XML 映射文件中： MyBatis 在启动时会解析这些包含特殊标签（如 <if>、<where>）的 SQL 语句，将其转换为一个可执行的 SqlSource 对象。当执行查询时，框架会根据传入的参数对象，计算 OGNL 表达式的值（如 test=“name != null and name != ‘’“），动态地决定是否包含某段 SQL，并最终生成一条完整的、可交由 JDBC 执行的静态 SQL 语句及参数列表。这个过程有效地防止了 SQL 注入，因为所有参数都是通过预编译语句（PreparedStatement）的占位符 ? 来设置的。
在注解中：通过 @SelectProvider、@UpdateProvider 等注解，可以指定一个类来动态生成 SQL 字符串，提供了基于 Java 代码的、更灵活的编程式动态 SQL 能力。

代码示例与常用标签

以下是一个典型的动态 SQL 查询示例，涵盖了最常用的几个标签：

<!-- UserMapper.xml -->
<select id="findActiveUserWithName" resultType="User">
    SELECT * FROM users
    <where>
        <!-- 条件判断：如果 status 不为 null，则拼接 AND 子句 -->
        <if test="status != null">
            AND status = #{status}
        </if>
        <!-- 复杂条件判断：支持 OGNL 表达式 -->
        <if test="name != null and name != ‘’">
            AND name like CONCAT(‘%‘, #{name}, ‘%‘)
        </if>
        <!-- 多条件选择，类似 Java 的 switch-case -->
        <choose>
            <when test="orderBy == ‘name‘">
                ORDER BY name
            </when>
            <when test="orderBy == ‘email‘">
                ORDER BY email
            </when>
            <otherwise>
                ORDER BY id
            </otherwise>
        </choose>
    </where>
</select>

<!-- 批量插入示例 -->
<insert id="batchInsertUsers">
    INSERT INTO users (name, email) VALUES
    <foreach collection="userList" item="user" separator=",">
        (#{user.name}, #{user.email})
    </foreach>
</insert>

常用标签解析：

<if>：基础条件判断。
<where> / <set>： 智能处理前缀。<where> 会智能地移除其内容首部的 AND 或 OR，并只在至少有一个子条件成立时才插入 WHERE 关键字。<set> 同理，用于 UPDATE 语句，智能处理后缀逗号。这是避免 WHERE 1=1 这种不优雅写法的官方推荐方案。
<choose>, <when>, <otherwise>：实现 “多选一” 逻辑。
<foreach>：遍历集合，常用于 IN 查询或批量操作。
<trim>：比 <where> 和 <set> 更底层的标签，可以自定义前缀/后缀的添加和移除规则，用于处理更复杂的字符串拼接。
<bind>：创建一个变量并将其绑定到上下文，用于简化表达式或解决数据库兼容性问题（如模糊查询时，不同数据库的 CONCAT 函数差异）。

最佳实践与常见误区

最佳实践：
1. 优先使用 <where> 和 <set>：告别 WHERE 1=1，让 SQL 更清晰、更符合规范。
2. 保持简洁：如果动态逻辑过于复杂，考虑将其拆分为多个独立的查询方法，或使用 @SelectProvider 用 Java 代码实现，以提升可读性和可测试性。
3. 善用 <trim>：在 <where> 和 <set> 无法满足的复杂裁剪场景下，<trim> 是利器。
4. 注意 OGNL 表达式： test 表达式中的属性名直接对应于参数对象（或 Map）的键。对于嵌套对象，使用 . 导航，如 user.name。
常见误区：
1. 在 test 表达式中错误引用属性：例如参数是 @Param(“u”) User user，则应该写 test=“u.name != null”，而非 test=“user.name != null”。
2. 忽视 <where> 标签的作用：仍然手动拼接 WHERE 和 AND，导致 SQL 语法错误或编写了不优雅的 1=1。
3. 过度使用动态 SQL：将大量业务逻辑塞进 XML，导致 SQL 映射文件臃肿难维护。动态 SQL 应主要服务于数据访问层的灵活性，而非承载核心业务逻辑。

总结

MyBatis 的动态 SQL 功能强大且实用，它通过一组基于 OGNL 的 XML 标签，让我们能以声明式、安全（防注入）且优雅的方式构建灵活多变的 SQL 语句，是应对复杂查询需求的利器，理解并正确使用其核心标签是 MyBatis 开发者的必备技能。

发布于2026年01月07日|10:18:18