1. 背景
插入timestamp
类型与datetime
类型数据比预计结果早13小时
2. 原因
如果说相差8
小时不够让人惊讶,那相差13
小时可能会让很多人摸不着头脑。出现这个问题的原因是JDBC
与MySQL
对 “CST
” 时区协商不一致。因为CST
时区是一个很混乱的时区,有四种含义:
美国中部时间Central Standard Time (USA) UTC-05:00
或UTC-06:00
澳大利亚中部时间Central Standard Time (Australia) UTC+09:30
中国标准时China Standard Time UTC+08:00
古巴标准时Cuba Standard Time UTC-04:00
MySQL
中,如果time_zone
为默认的SYSTEM
值,则时区会继承为系统时区CST
,MySQL
内部将其认为是UTC+08:00
。而jdbc
会将CST
认为是美国中部时间UTC -05:00
,这就导致会相差13
小时,如果处在冬令时还会相差14
个小时,这个时间与美中是(=13)否(=14)采用夏令时息息相关
。
3. 排错过程
在项目中,偶然发现数据库中存储的Timestamp
字段的unix_timestamp()
值比真实值少了13
个小时。通过调试追踪,发现了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 caseif (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
会误以为这是美国中部时间
UTC -0500
,因此TimeZone.getTimeZone(canonicalTimezone)
会给出错误的时区信息。
如图所示,本机默认时区是Asia/Shanghai +0800
,误认为服务器时区为UTC -0500
,实际上服务器是UTC +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()
得到的是刚才那个UTC -0500
。
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
误认为会话时区在美国中部时间
UTC-5
JBDC
把Timestamp+0
转为UTC-5
的String-5
MySQL
认为会话时区在UTC+8
,将String-5
转为Timestamp-13
最终结果相差 13 个小时!如果处在冬令时还会相差 14 个小时!
4. 解决方案
解决此问题的方法也很简单,我们可以明确指定MySQL
数据库的时区,不使用引发误解的CST
,可以将time_zone
改为'+8:00'
,同时jdbc
连接串中也可以增加serverTimezone=Asia/Shanghai
。
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)
或者修改f
文件,在 [mysqld
] 节下增加default-time-zone = '+08:00'
。修改时区操作影响深远,需要重启MySQL
服务器,建议在维护时间进行。
如何避免上述时区问题,可能你心里也有了些方法,简要总结几点如下:
首先保证系统时区准确。jdbc
连接串中指定时区,并与数据库时区一致。time_zone
参数建议设置为'+8:00'
,不使用容易误解的CST
。各环境数据库实例时区参数保持相同。
# 查看MySQL版本select VERSION();# 查看默认时区show variables like "%time_zone";