在 MyBatis 中处理数据库字段为空的查询场景时,需结合 SQL 语法 和 MyBatis 映射配置 双向优化,以下是核心方案与细节说明:

数据库层面:用 SQL 判空函数
MyBatis 最终执行的是原生 SQL,因此可通过 SQL 自带的判空函数直接过滤空值,不同数据库的判空语法略有差异,常见示例如下:
| 数据库类型 | 判空语法示例(查询 name 字段非空记录) |
说明 |
|---|---|---|
| MySQL | SELECT * FROM user WHERE name IS NOT NULL; |
用 IS NOT NULL 明确判断 |
| Oracle | SELECT * FROM user WHERE name IS NOT NULL; |
同 MySQL 语法 |
| PostgreSQL | SELECT * FROM user WHERE name IS NOT NULL; |
同 MySQL 语法 |
| SQL Server | SELECT * FROM user WHERE name IS NOT NULL; |
同 MySQL 语法 |
若需查询“空字符串”或 NULL,可组合条件:
-- 查询 name 为 NULL 或空字符串的记录 SELECT * FROM user WHERE name = '' OR name IS NULL;
MyBatis 映射层:XML 与注解的双向支持
XML 配置方式
在 Mapper 的 XML 文件中,通过 <select> 标签编写带判空逻辑的 SQL,利用 或 传递参数(推荐 防注入):
<!-- 查询 name 非空的用户 -->
<select id="selectUsersWithNonNullName" parameterType="map" resultType="User">
SELECT * FROM user
WHERE name IS NOT NULL
<if test="keyword != null and keyword != ''">AND name LIKE CONCAT('%', #{keyword}, '%')</if>
</select>
<if>标签动态拼接条件:先确保name非NULL,再根据keyword参数追加模糊查询;CONCAT()函数避免 SQL 注入风险(如直接拼%${keyword}%易被篡改)。
注解配置方式
使用 @Select 注解直接写 SQL,逻辑更简洁:

@Select("SELECT * FROM user WHERE name IS NOT NULL")
List<User> selectUsersWithNonNullName();
Java 实体类:处理空值的映射技巧
数据库 NULL 对应 Java 中的 null,但需注意 基本类型的默认值陷阱(如 int 默认为 0,而非 null),建议:
- 实体类字段用包装类型(如
Integer替代int),避免自动赋值错误; - 若需区分“空字符串”和
NULL,可在实体类添加业务逻辑(如StringUtils.isBlank()判断)。
特殊场景:多字段联合判空
当需同时过滤多个字段的空值时,可通过 AND 组合条件:
<select id="selectMultiFieldNonNull" resultType="User">
SELECT * FROM order
WHERE product_name IS NOT NULL
AND customer_id IS NOT NULL
AND order_time IS NOT NULL
</select>
相关问答 FAQs
Q1:为什么用 IS NOT NULL 而不用 ?
A:数据库中 NULL 是特殊值,表示“未知”。 仅能匹配空字符串,无法匹配 NULL;而 IS NOT NULL 能同时排除 NULL 和空字符串(需额外补充 OR name = '' 才能覆盖空字符串场景)。
Q2:MyBatis 动态 SQL 中如何优雅处理空值参数?
A:借助 <if> 标签动态拼接条件,结合 OGNL 表达式判断参数状态。

<select id="dynamicQuery" parameterType="User">
SELECT * FROM user
<where>
<if test="name != null and name != ''">AND name = #{name}</if>
<if test="age != null">AND age = #{age}</if>
</where>
</select>
此方式仅在参数有效时添加条件,避免无效 SQL 生成。
通过以上方案,可有效解决 MyBatis 查询数据库字段为空的问题,兼顾代码可读性与执行效率。