一、知识扫盲

JDBC:全称是java DataBase Connectivity
中文意思是java数据库连接
解释就是用于java编程语言和数据库之间的数据库无关的标准java API

二、错误展示

错误不好描述,直接看图:

三、分析原因

在服务器上执行“date”,看到时间,看到有CST字样
[root@dabiaoge ~]# date
Wed Jan 9 21:54:23 CST 2019
继续知识点扫盲:
CST时区
名为CST的时区是一个很混乱的时区,有四种含义:

美国中部时区Central Standard Time(USA)UTC-06:00
澳大利亚中部时区中央标准时间(澳大利亚)UTC + 09:30
中国标准时中国标准时区UTC + 08:00
古巴标准时古巴标准时区UTC-04:00

原因:CST的时区是一个很混乱的时区,在与MySQL协商会话时区时,Java会误以为是CST -0500或者CST -0600,而非CST +0800

解释原因是什么意思:
先来了解下美国的时区变化历史,美国规定每年从“3月11日”至“11月7日”实行夏令时,美国中部时区改为UTC-05:00;而“11月7日”至“3月11日”实行冬令时,美国中部时区改为UTC-06:00,博主的线上问题发现的时间是2019年1月9日,而此时美国中部的时区是UTC0600,而我们的时区是UTC0800,所以6+8=14个小时,因此线上的错误时间相隔14个小时。

四、排错过程

在项目中,偶然发现数据库中存储的 Timestamp 字段的 unix_timestamp() 值比真实值少了 14 个小时。通过调试追踪,发现了 com.mysql.cj.jdbc 里的时区协商有问题。
当 JDBC 与 MySQL 开始建立连接时,会调用 com.mysql.cj.jdbc.ConnectionImpl.initializePropsFromServer() 获取服务器参数,其中我们看到调用 this.session.configureTimezone() 函数,它负责配置时区。

public void configureTimezone() { String cOnfiguredTimeZoneOnServer= getServerVariable("time_zone"); if ("SYSTEM".equalsIgnoreCase(configuredTimeZoneOnServer)) { cOnfiguredTimeZoneOnServer= getServerVariable("system_time_zone"); } String canOnicalTimezone= getPropertySet().getStringReadableProperty(PropertyDefinitions.PNAME_serverTimezone).getValue(); if (configuredTimeZoneOnServer != null) { // user can override this with driver properties, so don't detect if that's the case if (canOnicalTimezone== null || StringUtils.isEmptyOrWhitespaceOnly(canonicalTimezone)) { try { canOnicalTimezone= TimeUtil.getCanonicalTimezone(configuredTimeZoneOnServer, getExceptionInterceptor()); } catch (IllegalArgumentException iae) { throw ExceptionFactory.createException(WrongArgumentException.class, iae.getMessage(), getExceptionInterceptor()); } } } if (canonicalTimezone != null && canonicalTimezone.length() > 0) { this.serverTimezOneTZ= TimeZone.getTimeZone(canonicalTimezone); // The Calendar class has the behavior of mapping unknown timezones to 'GMT' instead of throwing an exception, so we must check for this... if (!canonicalTimezone.equalsIgnoreCase("GMT") && this.serverTimezoneTZ.getID().equals("GMT")) { throw ... } } this.defaultTimeZOne= this.serverTimezoneTZ; }

追踪代码可知,当 MySQL 的 time_zone 值为 SYSTEM 时,会取 system_time_zone 值作为协调时区。
让我们登录到 MySQL 服务器验证这两个值:

mysql> show variables like '%time_zone%'; +------------------+--------+ | Variable_name | Value | +------------------+--------+ | system_time_zone | CST | | time_zone | SYSTEM | +------------------+--------+ 2 rows in set (0.00 sec)

重点在这里!若 String configuredTimeZoneOnServer 得到的是 CST 那么 Java 会误以为这是 CST -0600 ,因此 TimeZone.getTimeZone(canonicalTimezone) 会给出错误的时区信息。debug variables
本机默认时区是 Asia/Shanghai +0800 ,误认为服务器时区为 CST -0600 ,实际上服务器是 CST +0800 。

我们会想到,即便时区有误解,如果 Timestamp 是以 long 表示的时间戳传输,也不会出现问题,下面让我们追踪到 com.mysql.cj.jdbc.PreparedStatement.setTimestamp()

public void setTimestamp(int parameterIndex, Timestamp x) throws java.sql.SQLException { synchronized (checkClosed().getConnectionMutex()) { setTimestampInternal(parameterIndex, x, this.session.getDefaultTimeZone()); } }

注意到这里 this.session.getDefaultTimeZone() 得到的是刚才那个 CST -0600

private void setTimestampInternal(int parameterIndex, Timestamp x, TimeZone tz) throws SQLException { if (x == null) { setNull(parameterIndex, MysqlType.TIMESTAMP); } else { if (!this.sendFractionalSeconds.getValue()) { x = TimeUtil.truncateFractionalSeconds(x); } this.parameterTypes[parameterIndex - 1 + getParameterIndexOffset()] = MysqlType.TIMESTAMP; if (this.tsdf == null) { this.tsdf = new SimpleDateFormat("''yyyy-MM-dd HH:mm:ss", Locale.US); } this.tsdf.setTimeZone(tz); StringBuffer buf = new StringBuffer(); buf.append(this.tsdf.format(x)); if (this.session.serverSupportsFracSecs()) { buf.append('.'); buf.append(TimeUtil.formatNanos(x.getNanos(), true)); } buf.append('\''); setInternal(parameterIndex, buf.toString()); } }

原来 Timestamp 被转换为会话时区的时间字符串了。问题到此已然明晰:

JDBC 误认为会话时区在 CST-6
JBDC 把 Timestamp+0 转为 CST-6 的 String-6
MySQL 认为会话时区在 CST+8,将 String-6 转为 Timestamp-14

最终结果相差 14个小时!如果处在夏令时还会相差 13个小时

五、解决方法

解决办法非常的简单,手动明确指定 MySQL 数据库的时区,不使用引发误解的 CST:
临时生效:
mysql> set global time_zOne= '+08:00';
Query OK, 0 rows affected (0.00 sec)

mysql> set time_zOne= '+08:00';
Query OK, 0 rows affected (0.00 sec)

永久生效(修改后需要重启mysql):
修改 my.cnf 文件,在 [mysqld] 节下增加 default-time-zOne= '+08:00'