MyBatis如何查询数据库中字段值为空的记录？

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

数据库层面：用 SQL 判空函数

MyBatis 最终执行的是原生 SQL，因此可通过 SQL 自带的判空函数直接过滤空值，不同数据库的判空语法略有差异，常见示例如下：

若需查询“空字符串”或 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 查询数据库字段为空的问题,兼顾代码可读性与执行效率。