Mysql

关注公众号 jb51net

关闭
首页 > 数据库 > Mysql > mysql里CST时区的坑

mysql里CST时区的坑及解决

作者：石头wang

这篇文章主要介绍了mysql里CST时区的坑及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

一、问题简述

mysql 里 CST 时区是个非常坑的概念，因为在 mysql 里CST既表示中国也表示美国的时区。

但是在Jdk代码里，CST 这个字符串被理解为Central Standard Time (USA)（GMT-6），这就是造成坑的原因。

解决办法：

mysql 的 time_zone配置 不要用SYSTEM，因为用了就是跟随 system_time_zone 的值，而 system_time_zone 读取自数据库所在宿主机的操作系统，常常是 CST 的值。

解决办法是将 time_zone 改成例如 +08:00 以免造成误解。（肯定改mysql啦，你改得了jdk源码吗?）。

修改方法见后文

二、查看、修改时区

1、怎么查看mysql是什么时区?

选一个即可

方法1：

命令： 连上mysql后命令行执行 show variables like '%time_zone%' （Navicat连上后执行也行）

结果：

system_time_zone	CST
time_zone	SYSTEM

看time_zone就行了，SYSTEM表示其值跟随system_time_zone。

而system_time_zone的CST值，是表示中国呢，还是美国，是不清楚的，你直接再执行 select now() 跟你手机的时间对比一下就清楚了。

为什么会system_time_zone和time_zone两个? 要看哪个? 不急后面会解释

方法2：

命令：连上mysql后命令行执行 （Navicat连上后执行也行）

  // 分两次执行下面2条命令
  select @@system_time_zone;
  select @@time_zone;

结果：

  select @@system_time_zone;
  +--------------------+
  | @@system_time_zone |
  +--------------------+
  | CST                |
  +--------------------+
  1 row in set (4.81 sec)
  mysql> select @@time_zone;
  +-------------+
  | @@time_zone |
  +-------------+
  | SYSTEM      |
  +-------------+
  1 row in set (0.04 sec)

方法3：

// 查出全局时区和会话时区
select @@GLOBAL.time_zone,@@SESSION.time_zone;

为什么mysql有system_time_zone和time_zone两个

见 https://dev.mysql.com/doc/refman/8.0/en/time-zone-support.html

简单说就是system_time_zone就是mysql服务（即mysqld）启动的时候读取数据库所在宿主机的时区，固定下来的值，这个值之后不再改变（除非重启mysql服务）。time_zone的值未SYSTEM，意思是它的时区跟system_time_zone一样（注意system_time_zone的值固定下来后，数据库宿主机的时区再改变，time_zone的值都是不变的，因为它是跟随system_time_zone变量的，不是实时跟随操作系统的）

存在 “为什么linux时区是对的，但是mysql的时区是错的” 的疑惑，因为启动mysql服务时如果linux时区是错的，把mysql的时区也带错了，只是后来你发现linux时区错了于是改对了，但是你忘记启动mysql的时候linux时区是错的，而且你忘了是后来你才把linux的时区改正确的，所以你有这个的疑惑。我好像也有过这样的疑惑

2、如何修改mysql的时区

永久修改，改配置文件，重启mysql服务也有效

修改 my.cnf 文件，在 [mysqld] 节下增加 default-time-zone = '+08:00'

没有这个文件的话，见后文，让你的mysql启动的时候读取配置文件。

临时修改，重启mysql服务后丢失

选择下面之一执行即可。

三、这个bug 是怎么产生的

下面基于mysql-connector-java-8.0.19 进行分析，使用 com.mysql.cj.jdbc.Driver

在获取java.sql.Connection的过程会确定时区，调用如下方法

com.mysql.cj.protocol.a.NativeProtocol#configureTimezone
/**
    * Configures the client's timezone if required.
    * 
    * @throws CJException
    *             if the timezone the server is configured to use can't be
    *             mapped to a Java timezone.
    */
public void configureTimezone() {
String configuredTimeZoneOnServer = this.serverSession.getServerVariable("time_zone");
if ("SYSTEM".equalsIgnoreCase(configuredTimeZoneOnServer)) {
configuredTimeZoneOnServer = this.serverSession.getServerVariable("system_time_zone");
}
String canonicalTimezone = getPropertySet().getStringProperty(PropertyKey.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.serverSession.setServerTimeZone(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.serverSession.getServerTimeZone().getID().equals("GMT")) {
    throw ExceptionFactory.createException(WrongArgumentException.class, Messages.getString("Connection.9", new Object[] { canonicalTimezone }),
                                            getExceptionInterceptor());
}
}
this.serverSession.setDefaultTimeZone(this.serverSession.getServerTimeZone());
}

大概逻辑如下：

如果获取到CST，则因为在java里 TimeZone("CST")表示美国中部时间，与mysql数据库用 CST 表示中国时区的含义就不同了，bug就是这么产生的。

四、其他问题

1、CST究竟是美国还是中国

其实CST总共有4个含义

就是因为这个含义不清，所以会有坑，体现在Java里就是：

// 不建议这么创建 TimeZone，这里的CST指的是美国中部时间，不是中国，从
TimeZone tz = TimeZone.getTimeZone("CST");
System.out.println(tz);// 可以看到偏移量是offset=-21600000，-21600000微秒=-6小时，所以实锤这里的CST指美国
// 建议创建 TimeZone 用 ZoneId，因为ZoneId 不允许 CST、JST 这种简称，能提前预防进坑，如下
// ZoneId zoneId = ZoneId.of("CST");// 抛异常
ZoneId zoneId = ZoneId.of("GMT+8");// 明确指定，是OK的，或者 "区域/城市" 的写法如 Asia/Shanghai
TimeZone tz1 = TimeZone.getTimeZone(zoneId);

体现在Mysql里：

你根本不知道mysql里的CST是中国还是美国，查出来都展示一样

（关于system_time_zone和time_zone后续有解释）

2、你说CST除了表示中国，也表示美国定的时区，拿得出证据吗?

是的!!! 动手做实验给你看 !!!

使用show variables like '%time_zone%'; 查看mysql的时区，目前是北京时间，查出

Variable_name	Value
system_time_zone	CST
time_zone	SYSTEM

当把操作系统（mysql的宿主机器的操作系统）的时区改成东京时区，并重启mysql服务后（必须重启服务），显示

Variable_name	Value
system_time_zone	JST
time_zone	SYSTEM

最后把操作系统时区改成美国中部时间（如芝加哥），并重启mysql服务后，显示

Variable_name	Value
system_time_zone	CST
time_zone	SYSTEM

可以看到非常坑，无论是中国还是美国，都显示CST，给人很大的误解

五、其他

1、mybatis/jdbc 是怎么将日期存入到数据库的，又是怎么查出来的

（这个实在有点复杂，要考虑mysql所在操作系统的时区，也考虑跑你的mysql程序的web服务器的操作系统的时区。加又没时间继续研究了，缓一缓）

2、再次啰嗦补充

mysql里的 system_time_zone 和 time_zone是什么关系

system_time_zone 是mysql服务启动时读取宿主操作系统的时区，当时读取到什么值就固定什么，是那个时刻的快照。这个值只有在被重新指定或重启mysql服务的时候才可能变化。

time_zone就是表示所有连接到此mysql的客户端（client）的时区，不管你是什么形式的客户端，是java通过jdbc连接的程序，还是Navicat这种图形化的，还是命令行的，都叫客户端。这个时区是可以被覆盖的，可以被jdbcUrl中的时区覆盖。

在jdbc的URL里配置了时区会怎么样?

会使用这个时区，在jdbcUrl里指定的时区优先级最高，会覆盖其他。

例如 jdbc:mysql://localhost:3306/test?useSSL=true&serverTimezone=Asia/Shanghai

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:
阅读全文