SpringBoot+MyBatis避坑指南：Integer=0被当成空字符串的3种修复方案

SpringBoot+MyBatis零值陷阱：Integer=0被误判为空字符串的深度解决方案

在企业级应用开发中，状态字段的精确查询是业务逻辑的基础保障。当开发者使用SpringBoot整合MyBatis框架时，可能会遇到一个看似简单却影响深远的陷阱：Integer类型的0值在条件判断中被MyBatis隐式转换为空字符串，导致查询条件失效。这种现象不仅影响数据准确性，还可能引发业务逻辑的连锁问题。

1. 问题现象与根源剖析

1.1 典型问题场景重现

假设我们有一个定时任务配置表，其中包含状态字段：

CREATE TABLE timed_task (
  id BIGINT PRIMARY KEY,
  task_status TINYINT(1) COMMENT '任务状态：0-禁用 1-启用',
  is_active TINYINT(1) DEFAULT 1 COMMENT '逻辑删除标记'
);

对应的Mapper XML查询条件通常这样编写：

<select id="selectByStatus" resultType="TimedTask">
  SELECT * FROM timed_task
  WHERE is_active = 1
  <if test="taskStatus != null and taskStatus != ''">
    AND task_status = #{taskStatus}
  </if>
</select>

当传入taskStatus=0时，预期应该查询禁用状态的任务，但实际上MyBatis会跳过这个条件。通过日志可以看到生成的SQL语句中根本没有包含AND task_status = 0这部分。

1.2 底层机制解析

这种现象源于MyBatis的类型处理机制：

1. OGNL表达式评估：MyBatis使用OGNL表达式评估<if>条件，当Integer值为0时，status != ''会返回false
2. 隐式类型转换：MyBatis在比较Integer和String时，会将0转换为空字符串进行对比
3. 历史兼容性：这种行为是为了兼容早期版本中空字符串和零值的模糊处理方式

关键点验证：

• 传入1：条件生效 → true and true
• 传入0：条件失效 → true and false
• 传入null：条件失效 → false and false

2. 三种核心解决方案对比

2.1 JDBC连接参数配置法

实现步骤：

1. 修改application.yml中的数据库连接配置：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/db_name?tinyInt1isBit=false&zeroDateTimeBehavior=convert