在Mybatis框架的使用过程中，Java端的日期类型和MySQL数据库端的日期类型存在差异，两者比较时需要先做好类型映射，再选择合适的比较方式，否则很容易出现查询无结果、类型转换异常等问题。
Java和MySQL日期类型对应关系
首先要明确常用的Java日期类型和MySQL日期类型的对应情况，避免出现类型不匹配的问题，常见对应关系如下：
| Java日期类型 | MySQL日期类型 | 说明 |
|---|---|---|
| java.util.Date | DATE、DATETIME、TIMESTAMP | 通用日期类型，可对应MySQL多种日期类型 |
| java.sql.Date | DATE | 仅包含日期部分，无时间信息 |
| java.sql.Timestamp | TIMESTAMP、DATETIME | 包含日期和时间，精度到纳秒 |
| java.time.LocalDate | DATE | Java8新增日期类型，仅包含日期 |
| java.time.LocalDateTime | DATETIME、TIMESTAMP | Java8新增日期类型，包含日期和时间 |
Mybatis中日期比较的常用方式
方式一：直接参数映射比较
如果Java日期类型和MySQL日期类型映射正确，可以直接在SQL语句中比较，Mybatis会自动完成类型转换，示例代码如下：
<select id="selectByDate" resultType="com.example.User">
SELECT * FROM user
WHERE create_time >= #{startTime}
AND create_time <= #{endTime}
</select>
对应的Java接口方法定义：
List<User> selectByDate(@Param("startTime") LocalDateTime startTime, @Param("endTime") LocalDateTime endTime);
这种方式要求传入的Java日期类型和数据库字段类型兼容，比如MySQL的DATETIME字段可以接收LocalDateTime类型的参数。
方式二：使用动态SQL处理空值比较
实际开发中经常会遇到部分日期参数可能为空的情况，这时候可以使用动态SQL来拼接比较条件，避免空值导致的SQL错误：
<select id="selectByCondition" resultType="com.example.User">
SELECT * FROM user
WHERE 1=1
<if test="startTime != null">
AND create_time >= #{startTime}
</if>
<if test="endTime != null">
AND create_time <= #{endTime}
</if>
</select>
方式三：使用MySQL日期函数转换后比较
如果Java传入的日期格式和数据库字段格式不一致，或者需要按日期部分比较，可以使用MySQL的日期函数处理后再比较，比如使用DATE()函数提取日期部分：
<select id="selectByDatePart" resultType="com.example.User">
SELECT * FROM user
WHERE DATE(create_time) = DATE(#{targetDate})
</select>
也可以使用STR_TO_DATE()函数将字符串转为日期后比较：
<select id="selectByStrDate" resultType="com.example.User">
SELECT * FROM user
WHERE create_time > STR_TO_DATE(#{dateStr}, '%Y-%m-%d %H:%i:%s')
</select>
常见问题及解决方案
问题一：时区偏差导致比较结果错误
如果Java应用和MySQL服务器的时区不一致，日期比较可能会出现偏差，可以在Mybatis连接URL中指定时区：
jdbc:mysql://127.0.0.1:3306/test?serverTimezone=Asia/Shanghai
问题二：类型不匹配导致转换异常
如果出现java.lang.ClassCastException等类型转换异常，需要检查Java参数类型和数据库字段类型是否匹配，比如java.sql.Date只能对应MySQL的DATE类型，不能对应DATETIME类型，这时候可以改用java.sql.Timestamp或者LocalDateTime类型。
问题三：比较精度问题
如果只需要比较日期部分，不要直接用DATETIME类型和DATE类型比较，建议使用DATE()函数统一格式后再比较，避免出现时间部分导致的匹配错误。
MybatisJava_dateMySQL_date日期比较修改时间：2026-06-21 04:03:19