【原创】升级需谨慎，开发两行泪！——记一次MySQL驱动包升级引发的事故

news2024/9/28 19:17:35

一、背景

最近项目组在版本迭代时，组件也要进行升级，此时涉及到MySQL驱动包jdbc的版本升级。即从5.1.X升级到8.0.X。

然鹅在上线之后就出现了一部分兼容性问题，造成了一次“事故”：调用接口出现“系统错误”。查看日志：java.time.LocalDateTime cannot be cast to java.util.Date，也就是出现时间转换异常。

另外使用jFinal进行数据库连接处理。

二、问题排查

根据异常堆栈，找到异常抛出的位置：

由此得知，使用mybatis进行SQL的查询时，使用的是Map来接收数据，key是字段名，value则是具体的数据，且为Object，即可接收任何类型的对象数据。异常指出其Object具体为LocalDateTime，而不是Date类型。

根据git log知道，老代码基本上没改过，可能的原因就是本次MySQL驱动包的升级，造成的。那么到底是为什么呢？

本地环境进行debug跟踪，调整不同的MySQL驱动包mysql-connector-java，发现了最终的原因所在。

MySQL 5.1.X版本：

可以看到，MySQL驱动包处理datetime时间类型是使用java.sql.TimeStamp（extends Date）进行构造处理，最后转化为Date类型。

调用栈如下：

MySQL 8.0.X版本：

通过MySQL 8.0.X驱动包源码知道，DateTime类型的数据使用的是LocalDateTime，LocalDateTime是Java 8特性的。所以，在新驱动版本中，已经使用上Java 8的相关特性。

调用栈如下：

三、MySQL版本

接下来我们来了解下MySQL驱动包对于时间类型DateTime的问题跟踪。

3.1、升级的原因及MySQL8.0版本新特性

1. 性能：MySQL 8.0 的速度要比 MySQL 5.7 快 2 倍。MySQL 8.0 在以下方面带来了更好的性能：读/写工作负载、IO 密集型工作负载、以及高竞争（"hot spot"热点竞争问题）工作负载。

2. NoSQL：MySQL 从 5.7 版本开始提供 NoSQL 存储功能，目前在 8.0 版本中这部分功能也得到了更大的改进。该项功能消除了对独立的 NoSQL 文档数据库的需求，而 MySQL 文档存储也为 schema-less 模式的 JSON 文档提供了多文档事务支持和完整的 ACID 合规性。

3. 窗口函数(Window Functions)：从 MySQL 8.0 开始，新增了一个叫窗口函数的概念，它可以用来实现若干新的查询方式。窗口函数与 SUM()、COUNT() 这种集合函数类似，但它不会将多行查询结果合并为一行，而是将结果放回多行当中。即窗口函数不需要 GROUP BY。

4. 隐藏索引：在 MySQL 8.0 中，索引可以被“隐藏”和“显示”。当对索引进行隐藏时，它不会被查询优化器所使用。我们可以使用这个特性用于性能调试，例如我们先隐藏一个索引，然后观察其对数据库的影响。如果数据库性能有所下降，说明这个索引是有用的，然后将其“恢复显示”即可；如果数据库性能看不出变化，说明这个索引是多余的，可以考虑删掉。

5. 降序索引：MySQL 8.0 为索引提供按降序方式进行排序的支持，在这种索引中的值也会按降序的方式进行排序。

6. 通用表表达式(Common Table Expressions CTE)：在复杂的查询中使用嵌入式表时，使用 CTE 使得查询语句更清晰。

7. UTF-8 编码：从 MySQL 8 开始，使用 utf8mb4 作为 MySQL 的默认字符集。

8. JSON：MySQL 8 大幅改进了对 JSON 的支持，添加了基于路径查询参数从 JSON 字段中抽取数据的 JSON_EXTRACT() 函数，以及用于将数据分别组合到 JSON 数组和对象中的 JSON_ARRAYAGG() 和 JSON_OBJECTAGG() 聚合函数。

9. 可靠性：InnoDB 现在支持表 DDL 的原子性，也就是 InnoDB 表上的 DDL 也可以实现事务完整性了，要么失败回滚，要么成功提交，不至于出现 DDL 时部分成功的问题，此外还支持 crash-safe 特性，元数据存储在单个事务数据字典中。

10. 高可用性(High Availability)：InnoDB 集群为您的数据库提供集成的原生 HA 解决方案。

11. 安全性：对 OpenSSL 的改进、新的默认身份验证、SQL 角色、密码强度、授权。

3.2、MySQL 驱动8.0.X版本对DateTime的变更

Also, with the implementation of the new mechanism, a getObject(columnIndex) call on a DATETIME column returns a LocalDateTime object now instead of a String. To receive a String like before, use getObject(columnIndex, String.class) instead.

由此可见，针对DateTime类型的字段，在8.0.23的版本做了调整，直接返回LocalDateTime类型。

3.2、MySQL 驱动版本和Java版本的对应关系