来源:程序员江小北
👉 欢迎加入小哈的星球 ,你将获得: 专属的项目实战 / Java 学习路线 / 一对一提问 / 学习打卡 / 每月赠书
新项目:仿小红书(微服务架构)正在更新中... , 全栈前后端分离博客项目 2.0 版本完结啦, 演示链接:http://116.62.199.48/ 。全程手摸手,后端 + 前端全栈开发,从 0 到 1 讲解每个功能点开发步骤,1v1 答疑,直到项目上线。目前已更新了261小节,累计43w+字,讲解图:1806张,还在持续爆肝中.. 后续还会上新更多项目,目标是将Java领域典型的项目都整一波,如秒杀系统, 在线商城, IM即时通讯,Spring Cloud Alibaba 等等,戳我加入学习,已有1400+小伙伴加入(早鸟价超低)
背景简介
在一个老项目中,数据库采用的是 MySQL 5.7.36,ORM 框架使用的是 MyBatis 3.5.0,而 mysql-connector-java
的版本是 5.1.26。
有一天,一个精力充沛、充满折腾精神的年轻人加入了项目。
他觉得 MyBatis 的使用不够简单,需要写的代码比较多,因此认为有必要将其替换为 MyBatis-Plus。
MyBatis-Plus 替换 MyBatis
首先,我们准备了一张名为 tbl_order 的表,并初始化了其中的两条数据。
DROP TABLE IF EXISTS `tbl_order`;
CREATE TABLE `tbl_order` (
`id` bigint(0) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '自增主键',
`order_no` varchar(50) NOT NULL COMMENT '订单号',
`pay_time` datetime(3) DEFAULT NULL COMMENT '付款时间',
`created_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
`updated_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '最终修改时间',
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB COMMENT = '订单';
INSERT INTO `tbl_order` VALUES (1, '123456', '2024-02-21 18:38:32.000', '2024-02-21 18:37:34.000', '2024-02-21 18:40:01.720');
INSERT INTO `tbl_order` VALUES (2, '654321', '2024-02-21 19:33:32.000','2024-02-21 19:32:12.020', '2024-02-21 19:34:03.727');
为了简化演示,我们直接使用 MyBatis-Plus 构建了一个示例 demo,以此来模拟这位年轻人的替换过程。
我们只是简单地将 MyBatis-Plus 替换了 MyBatis,而其他组件的版本保持不变。
我们使用的 MyBatis-Plus 版本是这位年轻人引用的版本:3.1.1,
而 mysql-connector-java
的版本保持不变,仍然是 5.1.26。
示例代码:play_it_safe
然后,运行 com.qsl.OrderTest#orderListAllTest
,却遇到了报错,异常信息如下所示:
请注意 Caused by
部分。
![681b61baeb0f6007684efc38a456e29b.png](https://img-blog.csdnimg.cn/img_convert/681b61baeb0f6007684efc38a456e29b.png)
不支持的转换类型:java.time.LocalDateTime
是谁不支持呢?是 mysql-connector-java
不支持!
那么,哪个版本的 mysql-connector-java
支持呢?
❝
答案是:5.1.37
❞
![1c2157ce7ce747b02f1b4c8e335e6567.png](https://img-blog.csdnimg.cn/img_convert/1c2157ce7ce747b02f1b4c8e335e6567.png)
升级 mysql-connector-java
我们将 mysql-connector-java
升级到 5.1.37,然后再次执行 com.qsl.OrderTest#orderListAllTest
。
![f75af9889a8f5b5312ce316f344cbc3b.png](https://img-blog.csdnimg.cn/img_convert/f75af9889a8f5b5312ce316f344cbc3b.png)
这次不再报异常,并且查询结果也是正确的。
看起来,MyBatis-Plus 替换 MyBatis 的任务完成了。
这一切都如此顺利,让人有些怀疑。
![b2da7f2cab5925c8c181a79be7cabbf8.png](https://img-blog.csdnimg.cn/img_convert/b2da7f2cab5925c8c181a79be7cabbf8.png)
让我们再回头看看之前提到的异常:
Conversion not supported for type java.time.LocalDateTime
在替换 MyBatis 之前并没有这个异常,但在替换之后就出现了这个异常,这难道不是 MyBatis-Plus 的问题吗?
那么如何找到这个异常的根本原因呢?
其实很简单,直接从异常堆栈入手。
![ac2c95c63719dfe16d7ab02cfda8c564.png](https://img-blog.csdnimg.cn/img_convert/ac2c95c63719dfe16d7ab02cfda8c564.png)
点击后,你会发现代码非常简单。
![4b9287ccccf886304a166b45a2e84f7e.png](https://img-blog.csdnimg.cn/img_convert/4b9287ccccf886304a166b45a2e84f7e.png)
这么简单的代码怎么会有问题呢?
大家请注意图中左上角的 MyBatis 版本,是 3.5.1,而不是最初的 3.5.0。
可能有人会问:「既然替换成了 MyBatis-Plus,为什么还有 Mybatis 的存在?」
这个问题问得确实好,我只想给你个大嘴巴。
![df65ae2c40cfbffa4bdc6dff2f886f82.png](https://img-blog.csdnimg.cn/img_convert/df65ae2c40cfbffa4bdc6dff2f886f82.png)
现在让我们看一下 MyBatis-Plus 的官方说明。
![5e521a885aa2cd0ba4dc2a7d1c724489.png](https://img-blog.csdnimg.cn/img_convert/5e521a885aa2cd0ba4dc2a7d1c724489.png)
既然基于 Mybatis 3.5.0 没有抛出异常,而基于 3.5.1 却抛出了异常。
❝
“LocalDateTimeTypeHandler” 在 3.5.1 中肯定进行了调整
❞
那我们来看看调整了什么?
![5320b45aaefb1a1a6d749102338f0b81.png](https://img-blog.csdnimg.cn/img_convert/5320b45aaefb1a1a6d749102338f0b81.png)
看出什么了吗?
MyBatis 3.5.0 会处理 LocalDateTime
类型的转换(将 java.sql.Timestamp
转换成 java.time.LocalDateTime
)。
然而,注意了啊,最关键的地方来了!
从 MyBatis 3.5.1 开始,不再处理 LocalDateTime
(还包括:LocalDate、LocalTime)类型的转换,而是交由 JDBC 组件,也就是 mysql-connector-java
来实现。
而巧的是:
❝
mysql-connector-java 5.1.26 不支持类型 LocalDateTime。
❞
![ea5b5e79c17570959054219b62bb41af.png](https://img-blog.csdnimg.cn/img_convert/ea5b5e79c17570959054219b62bb41af.png)
那么它支持哪些类型呢?
我们同样从异常堆栈入手。
![86b357698ae087004f2c4bd9adf39012.png](https://img-blog.csdnimg.cn/img_convert/86b357698ae087004f2c4bd9adf39012.png)
点击后,可以看到下图。
![efc06df6cad3c6b4d3b6329c08191b36.png](https://img-blog.csdnimg.cn/img_convert/efc06df6cad3c6b4d3b6329c08191b36.png)
往上滑动鼠标,就可以看到支持的类型。
确实没有 LocalDateTime、LocalDate 和 LocalTime。
❝
mysql-connector-java 5.1.37 开始支持 LocalDateTime、LocalDate 和 LocalTime,前面已经介绍过了,不再赘述。
❞
总结异常根本原因:
❝
MyBatis 3.5.1 开始不再处理 LocalDateTime、LocalDate 和 LocalTime 的转换,而 mysql-connector-java 5.1.37 之前都不支持这些类型。
❞
搞清楚了这个异常的来龙去脉,顺理成章的感觉是不是又回来了?
暴风雨来临
版本上线不到两天,该来的终究还是来了。
我们往表 tbl_order
中插入了一条记录:
INSERT INTO tbl_order
VALUES (3, 'asdfgh', NULL, '2024-02-21 20:01:31.111', '2024-02-21 20:02:56.764');
然后再次执行 com.qsl.OrderTest#orderListAllTest
。
![d29820b5255f98a28c0d36f361b0a4e7.png](https://img-blog.csdnimg.cn/img_convert/d29820b5255f98a28c0d36f361b0a4e7.png)
此时我就想问这位年轻人:爽不爽?
![d526e2716b83b4192567b94f83ba9275.png](https://img-blog.csdnimg.cn/img_convert/d526e2716b83b4192567b94f83ba9275.png)
遇到了异常,那就找出原因。
同样从异常堆栈入手。
![959f1e9f489c750e9fb40c5e7df36bec.png](https://img-blog.csdnimg.cn/img_convert/959f1e9f489c750e9fb40c5e7df36bec.png)
看出什么了吗?
如果 getTimestamp(columnIndex)
得到的是 NULL,那不就是 NullPointerException
?这也太不严谨了吧?
修复问题是当务之急,先看哪个版本进行了修复?
![84b5c3797f5a137c3f7d03aa6aebb72a.png](https://img-blog.csdnimg.cn/img_convert/84b5c3797f5a137c3f7d03aa6aebb72a.png)
将 mysql-connector-java 升级到 5.1.42。
![e5fae04d07039c227054faeb51d1633a.png](https://img-blog.csdnimg.cn/img_convert/e5fae04d07039c227054faeb51d1633a.png)
问题得以修复。
❝
经过这一次事件,这位年轻人似乎成长了许多,但眼中的光却黯淡了不少。
❞
Mybatis-Plus 的问题
无意中我看到了这个 issue-1114,是不是和我们之前分析的 “Conversion not supported for type java.time.LocalDateTime
” 是同一个问题?
只是我们使用的数据库连接池是默认的 HikariCP 而非 Druid。
结合 druid/issues/3302
,如果使用 Druid 作为数据库连接池,出现的异常可能与我们之前分析的确实不同。
因此,大家需要根据自己的实际情况进行分析,但对异常的分析方法是通用的。
总结
关于组件的升级或旧代码的调整,都可能引发连锁反应,影响重大。
我的观点是:
❝
能不动就不要动,改好没功劳,改坏要背锅,吃力不讨好,又不是必须要改。
❞
如果不得不改,那就需要全面的测试。
👉 欢迎加入小哈的星球 ,你将获得: 专属的项目实战 / Java 学习路线 / 一对一提问 / 学习打卡 / 每月赠书
新项目:仿小红书(微服务架构)正在更新中... , 全栈前后端分离博客项目 2.0 版本完结啦, 演示链接:http://116.62.199.48/ 。全程手摸手,后端 + 前端全栈开发,从 0 到 1 讲解每个功能点开发步骤,1v1 答疑,直到项目上线。目前已更新了261小节,累计43w+字,讲解图:1806张,还在持续爆肝中.. 后续还会上新更多项目,目标是将Java领域典型的项目都整一波,如秒杀系统, 在线商城, IM即时通讯,Spring Cloud Alibaba 等等,戳我加入学习,已有1400+小伙伴加入(早鸟价超低)
1. 我的私密学习小圈子~
2. 面试官:Spring 为什么不支持 static 字段的注入?
3. 企业级消息推送架构设计,太强了!
4. @Transactional 中使用线程锁导致了锁失效,惊了!
最近面试BAT,整理一份面试资料《Java面试BATJ通关手册》,覆盖了Java核心技术、JVM、Java并发、SSM、微服务、数据库、数据结构等等。
获取方式:点“在看”,关注公众号并回复 Java 领取,更多内容陆续奉上。
PS:因公众号平台更改了推送规则,如果不想错过内容,记得读完点一下“在看”,加个“星标”,这样每次新文章推送才会第一时间出现在你的订阅列表里。
点“在看”支持小哈呀,谢谢啦