MyBatis动态SQL字符串空值判断，这个细节99%的程序员都踩过坑！

一、背景介绍

MyBatis作为主流的持久层框架之一，广泛应用于Java Web开发中。它通过动态SQL语句提供了灵活强大的数据库操作能力。然而在使用动态SQL构建条件查询时，初学者常常会遇到一些细节问题，比如在判断字符串参数时，容易混淆不同的空值判断方式，从而产生意想不到的结果。

二、具体案例分析

假设我们需要实现一个员工信息查询的功能，可以通过姓名（name）、性别（gender）和入职日期范围（begin和end）进行条件过滤。下面是一个MyBatis的XML配置案例：

xml 复制代码

<!-- EmpMapper.xml -->
<mapper namespace="cn.wolfcode.mapper.EmpMapper">

    <!-- 分页查询 -->
    <select id="page" resultType="cn.wolfcode.domain.Emp">
        SELECT * FROM emp LIMIT #{start}, #{pageSize}
    </select>

    <!-- 统计总记录数 -->
    <select id="count" resultType="java.lang.Integer">
        SELECT COUNT(*) FROM emp
    </select>

    <!-- 条件列表查询 -->
    <select id="list" resultType="cn.wolfcode.domain.Emp">
        SELECT * FROM emp
        <where>
            <if test="name != null and name != ''">
                name LIKE CONCAT('%', #{name}, '%')
            </if>
            <if test="gender != null">
                AND gender = #{gender}
            </if>
            <if test="begin != null and end != null">
                AND hiredate BETWEEN #{begin} AND #{end}
            </if>
        </where>
        ORDER BY update_time DESC
    </select>

</mapper>

在上述代码中，有这样一段判断：

xml 复制代码

<if test="name != null and name != ''">

乍一看，这个判断非常清晰，它试图避免在姓名为空（null或者空字符串）的情况下拼接SQL条件。但我们再来看另一种类似的写法：

xml 复制代码

<if test="name != null and name != ' '">

你会发现，上述两段代码只有细微差别------第二段代码中判断的是空格，而不是空字符串。这种看似无关紧要的差别却可能带来巨大影响。

三、问题深入剖析

在MyBatis中，动态SQL的判断条件语句使用的是OGNL表达式进行判断。我们逐步分析上面两种写法的实际效果：

第一种写法：name != null and name != ''
- 如果name是null，条件不成立，不执行拼接。
- 如果name是空字符串""，条件依旧不成立。
- 如果name是空格" "或其他任何非空字符串，条件成立，执行拼接。
第二种写法：name != null and name != ' '（单个空格字符）
- 如果name是null，条件不成立，不执行拼接。
- 如果name是空字符串""，条件成立，因为""不等于单个空格。
- 如果name恰好为单个空格" "，条件不成立，不拼接。

由此可见，第二种写法判断了一个特殊且非常狭义的情况，几乎无实际意义，反而容易造成逻辑上的混乱，通常并不推荐使用。

四、更优的解决方案

那么，在实际开发中，我们究竟应该怎样处理字符串判空更为合理呢？更好的方式应当考虑到参数可能存在前后空格或多个空白字符的情况。因此，我们建议在后端代码接收参数时，进行预处理（trim去掉前后空格），再用统一的方法判断是否为空：

Java后台示例代码：

java 复制代码

// 处理查询参数
public void handleQueryParam(EmpQuery query) {
    if (query.getName() != null) {
        query.setName(query.getName().trim());
        if (query.getName().isEmpty()) {
            query.setName(null);
        }
    }
}

此时，MyBatis的动态SQL判断可以简化为：

xml 复制代码

<if test="name != null">
    name LIKE CONCAT('%', #{name}, '%')
</if>

这样一来，参数处理责任明确，MyBatis的判断逻辑也变得清晰易读，减少出错的可能。

五、小结与反思

在MyBatis使用动态SQL进行参数判断时，一定要注意对字符串的判空方式。建议明确空字符串和空格字符的区别，避免犯类似的小错误。同时，通过在后台统一处理参数（如trim）来优化MyBatis的条件判断逻辑，能够显著提升代码的健壮性和可维护性。

只有在细节上严谨，代码质量才能不断提高，业务功能才能更加稳定可靠。

希望这篇博客能帮你彻底理解并记住这个问题，从此告别类似的细节坑。加油！