在一个老项目中，数据库采用的是 MySQL 5.7.36，ORM 框架使用的是 MyBatis 3.5.0，而
mysql-connector-java
的版本是 5.1.26。
有一天，一个精力充沛、充满折腾精神的年轻人加入了项目。
他觉得 MyBatis 的使用不够简单，需要写的代码比较多，因此认为有必要将其替换为 MyBatis-Plus。
基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能
-
项目地址：https://github.com/YunaiV/ruoyi-vue-pro
-
视频教程：https://doc.iocoder.cn/video/
首先，我们准备了一张名为 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
部分。
不支持的转换类型：
java.time.LocalDateTime
是谁不支持呢？是
mysql-connector-java
不支持！
那么，哪个版本的
mysql-connector-java
支持呢？
❝
答案是：5.1.37
❞
基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能
-
项目地址：https://github.com/YunaiV/yudao-cloud
-
视频教程：https://doc.iocoder.cn/video/
我们将
mysql-connector-java
升级到 5.1.37，然后再次执行
com.qsl.OrderTest#orderListAllTest
。
这次不再报异常，并且查询结果也是正确的。
看起来，MyBatis-Plus 替换 MyBatis 的任务完成了。
这一切都如此顺利，让人有些怀疑。
让我们再回头看看之前提到的异常：
Conversion not supported for type java.time.LocalDateTime
在替换 MyBatis 之前并没有这个异常，但在替换之后就出现了这个异常，这难道不是 MyBatis-Plus 的问题吗？
那么如何找到这个异常的根本原因呢？
其实很简单，直接从异常堆栈入手。
点击后，你会发现代码非常简单。
这么简单的代码怎么会有问题呢？
大家请注意图中左上角的 MyBatis 版本，是 3.5.1，而不是最初的 3.5.0。
可能有人会问：
「既然替换成了 MyBatis-Plus，为什么还有 Mybatis 的存在？」
这个问题问得确实好，我只想给你个大嘴巴。
现在让我们看一下 MyBatis-Plus 的官方说明。
既然基于 Mybatis 3.5.0 没有抛出异常，而基于 3.5.1 却抛出了异常。
❝
“LocalDateTimeTypeHandler” 在 3.5.1 中肯定进行了调整
❞
那我们来看看调整了什么？
看出什么了吗？
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。
❞
那么它支持哪些类型呢？
我们同样从异常堆栈入手。
点击后，可以看到下图。
往上滑动鼠标，就可以看到支持的类型。
确实没有 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
。
此时我就想问这位年轻人：爽不爽？
