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服务后丢失

选择下面之一执行即可。
- 修改会话级别定的，关闭会话后就会失效，也仅仅影响当前会话窗口：set time_zone='+08:00';
- 全局修改，重启mysql服务后丢失，对所有会话生效：`set global time_zone=’+08:00’;

三、这个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());
}

大概逻辑如下：

从mysql的time_zone读取值
如果值是SYSTEM则使用system_time_zone的值
如果jdbc url配置了时区则使用url里的，如 jdbc:mysql://localhost:3306/test?useSSL=true&serverTimezone=Asia/Shanghai获取的是字符串配置定的

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

四、其他问题

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

其实CST总共有4个含义

China Standard Time：中国标准时间
Central Standard Time (USA) ：美国中部时间（中部就是在国土的中间的部分，例如芝加哥）
Central Standard Time (Australia)：澳大利亚中部时间
Cuba Standard Time：古巴标准时间

就是因为这个含义不清，所以会有坑，体现在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
time_zone的SYSTEM是什么意思，是不是指 “操作系统” 的时区?
time_zone的SYSTEM，是指值跟随 system_time_zone 的值，不是说跟随操作系统的值，操作系统的时区改了，如果 system_time_zone 不改，则 time_zone 也是不会改的（亲自实验过了!!）