MyBatis 动态构建多条件运算符的完整实践指南

本文详解如何在 Spring Boot + MyBatis 项目中，通过扩展实体类与灵活使用 、 等动态 SQL 标签，支持 =, >,

本文详解如何在 spring boot + mybatis 项目中，通过扩展实体类与灵活使用 ``、`` 等动态 sql 标签，支持 `=`, `>`, `

在实际业务开发中，仅靠 age = #{student.age} 这类静态等值条件远远无法满足前端分页筛选、管理后台高级搜索等场景需求。例如：用户可能希望查询“年龄大于18”、“姓名包含‘张’”、“年级在2021–2023之间”或“状态为启用/禁用”的学生列表。此时，必须将查询逻辑从“字段直传”升级为“条件语义化建模”。

✅ 推荐方案：引入条件封装字段（推荐用于简单范围与基础运算）

最轻量且可维护性高的做法是扩展查询 DTO（如 StudentQuery），避免污染核心实体 Student。例如：

public class StudentQuery {
    private String name;           // 支持模糊匹配
    private Integer minAge;        // age >= minAge
    private Integer maxAge;        // age <= maxAge
    private List<String> statuses; // status IN (...)
    private String orderBy;        // 动态排序字段（可选）
    private String orderDir;       // ASC / DESC（可选）
    private Pageable pageable;
    // getter/setter...
}

对应 MyBatis XML 中编写结构清晰的动态 SQL：

<select id="listStudent" resultType="Student">
    SELECT * FROM student
    <where>
        <if test="query.name != null and query.name != ''">
            AND name LIKE CONCAT('%', #{query.name}, '%')
        </if>
        <if test="query.minAge != null">
            AND age >= #{query.minAge}
        </if>
        <if test="query.maxAge != null">
            AND age <= #{query.maxAge}
        </if>
        <if test="query.statuses != null and query.statuses.size() > 0">
            AND status IN
            <foreach item="status" collection="query.statuses" open="(" separator="," close=")">
                #{status}
            </foreach>
        </if>
    </where>
    <if test="query.orderBy != null and query.orderDir != null">
        ORDER BY ${query.orderBy} ${query.orderDir}
    </if>
</select>

⚠️ 注意事项：

库宝AI

库宝AI是一款功能多样的智能伙伴助手，涵盖AI写作辅助、智能设计、图像生成、智能对话等多个方面。

下载

• 使用 >= 和 <= 而非 >= /
• ${} 仅用于 受信的、固定枚举值字段名/排序方向（如 orderBy），严禁拼接用户输入内容，防止 SQL 注入；
• LIKE 拼接推荐使用 CONCAT('%', ..., '%')，比 "%" + name + "%" 更安全（避免空指针与边界问题）；
• Pageable 不建议直接传入 DAO 层，应由 MyBatis-Plus 或手动添加 LIMIT #{pageable.offset}, #{pageable.pageSize}（需确保 Pageable 已初始化）。

✅ 进阶方案：使用 实现互斥条件（如“精确匹配 or 范围查询 or 模糊搜索”）

当同一字段需支持多种互斥语义时（例如：age 字段支持 =, >, BETWEEN 三选一），可用 替代多个 ：

<if test="query.ageCondition != null">
    <choose>
        <when test="query.ageCondition.type == 'EQ'">
            AND age = #{query.ageCondition.value}
        </when>
        <when test="query.ageCondition.type == 'GT'">
            AND age > #{query.ageCondition.value}
        </when>
        <when test="query.ageCondition.type == 'BETWEEN'">
            AND age BETWEEN #{query.ageCondition.min} AND #{query.ageCondition.max}
        </when>
    </choose>
</if>

配合 Java 类：

public class AgeCondition {
    private String type; // EQ / GT / BETWEEN
    private Integer value;
    private Integer min;
    private Integer max;
}

✅ 最佳实践总结

通过合理设计查询参数模型与精准运用 MyBatis 动态 SQL，你不仅能优雅支持多样化查询需求，还能显著提升代码可读性、可测试性与安全性。记住：好的查询接口，始于清晰的契约设计，成于严谨的 SQL 构建。