MyBatis SQL比较语法：特殊字符的正确处理方式

MyBatis开发者经常会遇到这样的问题：在XML映射文件中写SQL，使用>=和<=时总是报错。明明SQL本身没问题，为什么MyBatis解析不了？

这是因为XML语言本身的限制。XML将<和>视为标签的组成部分，当SQL中出现这些字符时，XML解析器会误以为这是XML标签，导致解析失败。理解这个原理，就能掌握正确的写法。

比较运算符转义对照表

在MyBatis XML映射文件中，比较运算符需要使用特定的转义方式：

问题根源：XML解析机制

XML解析器在读取XML文档时，会按照以下规则解析：

1. 遇到<：解析器认为这是XML元素的开始，如<select>、<if>
2. 遇到>：解析器认为这是XML元素的结束
3. 遇到&：解析器认为这是实体的开始，如<、&

当SQL语句中包含age >= 18时：

• XML解析器看到>会寻找对应的开始标签
• 但前面只有age =，没有开始标签
• 解析器报错：标签未正确闭合

这就是为什么需要使用转义字符的原因。

标准转义写法示例

案例1：单条件查询

查询积分大于等于1000的用户：

<select id="selectVipUsers" resultType="User">
    SELECT id, name, score 
    FROM users 
    WHERE score &gt;= 1000
</select>

转义原因：>=会被XML解析器转换为>=，然后传给数据库执行。如果不转义，XML解析阶段就会失败。

案例2：范围查询

查询价格在指定范围内的商品：

<select id="selectProductsByPrice" resultType="Product">
    SELECT * FROM products
    WHERE price &gt;= #{minPrice}
    AND price &lt;= #{maxPrice}
</select>

转义原因：两个比较运算符都需要转义。>=表示大于等于，<=表示小于等于。XML解析器会先处理转义字符，再交给MyBatis处理SQL。

案例3：动态条件查询

根据传入参数动态构建查询条件：

<select id="selectByConditions" resultType="Order">
    SELECT * FROM orders
    WHERE 1=1
    <if test="minAmount != null and minAmount &gt; 0">
        AND amount &gt;= #{minAmount}
    </if>
    <if test="maxAmount != null">
        AND amount &lt;= #{maxAmount}
    </if>
    <if test="startDate != null">
        AND create_time &gt;= #{startDate}
    </if>
</select>

转义原因：在<if>标签的test属性中，如果使用>=，XML解析器无法正确解析。在SQL的WHERE子句中也需要转义，确保整个XML文档结构正确。

案例4：UPDATE语句

更新满足条件的记录：

<update id="updateLowStock">
    UPDATE products
    SET status = 'low_stock'
    WHERE stock &lt;= 10
    AND status = 'active'
</update>

转义原因：UPDATE语句的WHERE子句中的比较运算符同样需要转义。<=表示小于等于，XML解析器会正确识别。

案例5：DELETE语句

删除过期数据：

<delete id="deleteExpired">
    DELETE FROM sessions
    WHERE expire_time &lt;= NOW()
</delete>

转义原因：DELETE语句中的比较运算符需要遵循相同的转义规则。<=确保XML解析器不会将其误认为标签。

案例6：统计查询

统计满足条件的记录数：

<select id="countByRange" resultType="int">
    SELECT COUNT(*) 
    FROM orders
    WHERE amount &gt;= #{minAmount}
    AND amount &lt;= #{maxAmount}
    AND status = 'paid'
</select>

转义原因：聚合查询中的WHERE条件同样需要转义。即使只返回一个数字，SQL语句的语法规则不变。

案例7：复杂JOIN查询

多表关联查询，包含多个比较条件：

<select id="selectOrderDetails" resultType="OrderDetail">
    SELECT o.id, o.amount, u.name, p.product_name
    FROM orders o
    INNER JOIN users u ON o.user_id = u.id
    INNER JOIN products p ON o.product_id = p.id
    WHERE o.amount &gt;= #{minAmount}
    AND o.amount &lt;= #{maxAmount}
    AND o.create_time &gt;= #{startTime}
    AND o.create_time &lt;= #{endTime}
</select>

转义原因：复杂查询中的每个比较运算符都需要转义。多表关联不会改变XML解析规则，所有比较运算符都需要正确处理。

CDATA区域替代方案

除了转义字符，还可以使用CDATA区域，让XML解析器忽略区域内的内容：

CDATA示例1：完整SQL包裹

<select id="selectUsers" resultType="User">
    <![CDATA[
        SELECT * FROM users
        WHERE age >= 18
        AND age <= 65
        ORDER BY create_time DESC
    ]]>
</select>

使用原因：CDATA区域内的内容会被当作纯文本，XML解析器不会解析其中的特殊字符。适合静态SQL，不需要参数占位符的情况。

CDATA示例2：部分SQL包裹

<select id="selectByPrice" resultType="Product">
    SELECT * FROM products
    WHERE 1=1
    <if test="minPrice != null">
        <![CDATA[ AND price >= ]]> #{minPrice}
    </if>
    <if test="maxPrice != null">
        <![CDATA[ AND price <= ]]> #{maxPrice}
    </if>
</select>

使用原因：当需要结合动态SQL时，可以将比较运算符部分用CDATA包裹，参数占位符放在外面。这样既避免了转义，又能正确使用参数绑定。

两种方案对比

实际开发中的选择建议

推荐使用转义字符的场景

1. 简单SQL：只有一两个比较运算符
2. 动态SQL：需要频繁使用<if>、<choose>等标签
3. 参数较多：需要大量使用#{}占位符

推荐使用CDATA的场景

1. 复杂SQL：包含大量比较运算符和逻辑运算
2. 静态SQL：不需要动态条件，SQL相对固定
3. 可读性优先：团队更重视SQL的可读性

常见陷阱和解决方案

陷阱1：test属性中忘记转义

<!-- 错误 -->
<if test="age >= 18">
    AND age >= 18
</if>

<!-- 正确 -->
<if test="age &gt;= 18">
    AND age &gt;= 18
</if>

解决：test属性中的比较运算符也需要转义，因为XML解析器会先解析属性值。

陷阱2：CDATA中嵌套参数

<!-- 错误 -->
<![CDATA[ WHERE age >= #{age} ]]>

<!-- 正确 -->
<![CDATA[ WHERE age >= ]]> #{age}

解决：CDATA区域内的#{}不会被MyBatis处理，需要将占位符放在CDATA外面。

陷阱3：混合使用导致混乱

<!-- 不推荐 -->
<select>
    WHERE price <![CDATA[ >= ]]> 100
    AND stock &lt;= 50
</select>

解决：在同一个项目中统一使用一种方案，要么全部转义，要么全部用CDATA。

最佳实践总结

1. 统一规范：团队内部统一使用转义字符或CDATA，保持代码风格一致。
2. IDE辅助：使用IntelliJ IDEA、MyBatisX等插件，可以自动提示和检查。
3. 代码审查：在代码审查时重点关注特殊字符的处理。
4. 单元测试：编写测试用例验证包含比较运算符的SQL是否正确执行。
5. 文档记录：在项目README或开发规范中记录转义规则，方便新人查阅。

掌握MyBatis中比较运算符的正确写法，是使用MyBatis的基础技能。理解XML解析机制，选择适合的方案，可以避免很多不必要的错误。

🔗 相关工具

• 建议使用支持MyBatis的IDE插件（如MyBatisX）来辅助开发，可以自动提示转义字符