数据库时间慢了14个小时，Mybatis说，这个锅我不背

淡淡的烟草味﹌ 2023-09-29 16:06 16阅读 0赞

同事反馈一个问题：Mybatis插入数据库的时间是昨天的，是不是因为生成Mybatis逆向工程生成的代码有问题？

大家都知道，对于这类Bug本人是很感兴趣的。直觉告诉我，应该不是Mybatis的Bug，很可能是时区的问题。

很好，今天又可以带大家一起来排查Bug了，看看从这次的Bug排查中你能Get什么技能。

这次研究的问题有点深奥，但结论很重要。Let's go!

### 问题猜想 ###

同事反馈问题的时候，带了自己的猜想：是不是数据库字段设置为datetime导致？是不是Mybatis逆向工程生成的代码中类型不一致导致的？

同事还要把datetime改为varchar……马上被我制止了，说：先排查问题，再说解决方案，下午我也抽时间看看。

### 问题核查 ###

第一步，检查数据库字段类型，是`datetime`的，没问题。

第二步，检查实体类中类型，是`java.util.Date`类型，没问题。

第三步，Bug复现。

在Bug复现这一步，用到了单元测试。话说之前还跟朋友讨论过单元测试的魅力，现在本人是越来越喜欢单元测试了。

项目基于Spring Boot的，单元测试如下（代码已脱敏）：

@SpringBootTest
    class DateTimeTests {
    
     @Resource
     private UserMapper userMapper;
    
     @Test
     public void testDate(){
      User  user = new User();
      // 省略其他字段
      user.setCreateDate(new Date());
      userMapper.insertSelective(user);
     }
    }

执行单元测试，查看数据库中插入的数据。Bug复现，时间的确是前一天的，与当前时间相差14个小时。

经过上面三步的排查，核实了数据库字段和代码中类型没问题。单元测试也复现了问题，同事没有欺骗我，总要眼见为实，哈哈~

于是基本确定是时区问题。

### 时区排查 ###

检查服务器时间

登录测试服务器，执行date命令，检查服务器时间和时区：

[root@xxx ~]# date
    2021年 11月 25日 星期四 09:26:25 CST
    [root@xxx ~]# date -R
    Thu, 25 Nov 2021 09:33:34 +0800

显示时间是当前时间，采用CST时间，最后的+0800，即东8区，没问题。

检查数据库时区

连接数据库，执行show命令：

system\_time\_zone：全局参数，系统时区，在MySQL启动时会检查当前系统的时区并根据系统时区设置全局参数system\_time\_zone的值。值为CST，与系统时间的时区一致。

time\_zone：全局参数，设置每个连接会话的时区，默认为SYSTEM，使用全局参数system\_time\_zone的值。

检查代码中时区

在单元测试的方法内再添加打印时区的代码：

@Test
     public void testDate(){
      System.out.println(System.getProperty("user.timezone"));
      User  user = new User();
      // 省略其他字段
      user.setCreateDate(new Date());
      userMapper.insertSelective(user);
     }

打印的时区为：

Asia/Shanghai

也就是说Java中使用的是UTC时区进行业务逻辑处理的，也是东八区的时间。

那么问题到底出在哪里呢？

### 问题基本呈现 ###

经过上述排查，基本上确定是时区的问题。这里，再补充一下上述相关的时区知识点。

UTC时间

UTC时间：世界协调时间（UTC）是世界上不同国家用来调节时钟和时间的主要时间标准，也就是零时区的时间。

UTC, Coordinated Universal Time是一个标准，而不是一个时区。UTC 是一个全球通用的时间标准。全球各地都同意将各自的时间进行同步协调 (coordinated)，这也是UTC名字的来源：Universal Coordinated Time。

CST时间

CST时间：中央标准时间。

CST可以代表如下4个不同的时区：

*  Central Standard Time (USA) UT-6:00，美国
 *  Central Standard Time (Australia) UT+9:30，澳大利亚
 *  China Standard Time UT+8:00，中国
 *  Cuba Standard Time UT-4:00，古巴

再次分析

很显然，这里与UTC时间无关，它只是时间标准。目前Mysql中的system\_time\_zone是CST，而CST可以代表4个不同的时区，那么，Mysql把它当做哪个时区进行处理了呢？

简单推算一下，中国时间是UT+8:00，美国是 UT-6:00，当传入中国时间，直接转换为美国时间（未考虑时区问题）