MyBatis-Plus集成MyBatis时SQL查询结果不一致问题解析

问题背景

在实际开发中，很多项目会从原生MyBatis逐步迁移到MyBatis-Plus框架。在这个过程中，开发者可能会遇到一个典型问题：同样的SQL语句，在MyBatis中可以正常查询到数据，但在集成MyBatis-Plus后却查询不到结果。

问题现象

当项目从MyBatis 3.4.6升级到3.5.7版本，并引入MyBatis-Plus 3.5.0后，发现原有的SQL查询语句返回结果为空。而回退到原生MyBatis环境时，相同的SQL又能正常返回数据。

根本原因分析

经过深入排查，发现问题并非直接由MyBatis-Plus引起，而是由于在引入MyBatis-Plus时同步升级了MySQL驱动版本所致：

1. 原MySQL驱动版本：mysql-connector-java 5.1.42
2. 升级后MySQL驱动版本：mysql-connector-java 8.0.27

这个版本升级带来了JDBC行为的变化，特别是时间类型(TIMESTAMP)的处理方式：

• 高版本MySQL驱动(8.x)不再返回时间戳的毫秒部分
• 而低版本驱动(5.x)会完整返回时间戳信息
• 这种差异导致在结果集映射时出现匹配失败的情况

技术细节

当数据库字段类型为DATETIME，而Java实体类中使用的是java.sql.Timestamp类型时：

1. MySQL 5.x驱动会将DATETIME转换为完整的Timestamp对象，包含毫秒精度
2. MySQL 8.x驱动则可能截断毫秒部分
3. 这种精度差异可能导致：
   • 结果集映射时类型不匹配
   • 条件查询时比较失败
   • 缓存键生成不一致

解决方案

针对这个问题，可以采用以下几种解决方案：

1. 保持驱动版本一致：

   • 如果项目对MySQL 8.x特性没有强需求，可以回退到5.x版本的驱动
   • 确保开发、测试和生产环境使用相同版本的驱动

2. 显式配置类型处理器：

   • 为时间类型字段配置自定义的类型处理器
   • 确保在不同驱动版本下都能正确处理时间类型

3. 统一时间类型处理：

   • 在实体类中使用java.time包下的类型(LocalDateTime等)
   • 配置MyBatis的类型处理器来支持这些新类型

4. 升级策略优化：

   • 先升级驱动版本并验证所有功能
   • 确认无问题后再引入MyBatis-Plus
   • 分阶段进行技术栈升级

最佳实践建议

1. 依赖管理：

   • 使用dependencyManagement统一管理依赖版本
   • 避免间接依赖引入不兼容的版本

2. 升级测试：

   • 任何核心依赖升级都应进行充分测试
   • 特别关注时间类型字段的处理

3. 版本兼容性检查：

   • 查阅MyBatis、MyBatis-Plus和MySQL驱动的官方兼容性文档
   • 确保各组件版本相互兼容

4. 监控与日志：

   • 在升级过程中增加SQL日志输出
   • 监控数据映射过程中的警告和错误

总结

技术栈升级过程中，看似简单的一个依赖版本变化可能引发意想不到的问题。特别是在处理时间类型这种敏感数据时，不同版本的驱动可能有不同的实现方式。开发者在进行框架升级或引入新组件时，应该：

1. 充分了解各组件间的版本依赖关系
2. 制定详细的升级和回滚计划
3. 对核心功能进行全面的回归测试
4. 特别注意数据类型处理的兼容性问题

通过系统化的升级策略和充分的测试，可以最大限度地减少这类问题的发生，确保系统平稳过渡到新技术栈。