前言:最近,因为复习JDBC知识,使用了最新版本的mysql驱动程序(mysql-connector-java.jar),结果出现了之前从未遇到过的问题:The server time zone value ‘�й���׼ʱ��’ is unrecognized or represents more than one time zone。出于对未知的好奇,于是在网上查找出现该问题的具体原因,找了很久,浏览了许多文章,最常见的解答是:serverTimezone=UTC、serverTimezone=Asia/Shanghai或者降低mysql驱动程序的版本。但是,几乎没有看到有人解释问题发生的原因,也没有介绍time zone的概念,就只是给出来解决方法。在某篇博文中的评论中,我发现也有人问”为什么要这样设置(serverTimezone)“,有人回答mysql高版本驱动程序需要设置时区,这个答案让我感觉”听君一席话,如听一席话“,属于”废话文学“。最后,只能求助mysql官方文档,发现涉及到内容太多了,但是念念不忘,必有回响。坚持不懈了三天,总算对问题有了全面的认知。

一 、问题发生

系统环境:JDK 1.8、mysql-connector-java 8.0.23(mysql驱动程序)、mysql数据库 8.0.28

代码如下:

String url = "jdbc:mysql://localhost:3306/crashcourse?useUnicode=true&characterEncoding=utf8";

Class.forName("com.mysql.cj.jdbc.Driver");
Connection conn = DriverManager.getConnection(url, "root", "admin");

// 其他与数据库交互的代码省略

在IDEA运行后,出现错误,如下图所示:

在这里插入图片描述

二、 问题解决

报错信息中,包含了对解决问题方法的描述。

You must configure either the server or JDBC driver (via the ‘serverTimezone’ configuration property) to use a more specifc time zone value if you want to utilize time zone support.

翻译:如果你想运用时区支持,必须配置服务器JDBC驱动程序(通过’ serverTimezone '配置属性)来使用更具体的时区值。

解决方案一:配置服务器

1. 临时配置

重启服务器会失效。使用具有权限的(配置全局变量,可以是root用户)用户,登陆到mysql服务器,运行以下命令:

mysql> set global time_zone='+8:00';
Query OK, 0 rows affected (0.00 sec)

2. 永久配置

在my.ini中添加配置项(Windwos系统中,my.ini文件位置:C:\ProgramData\MySQL\MySQL Server 8.0),重启服务器生效。

[mysqld]
default-time-zone = '+8:00'

解决方案二:配置JDBC驱动程序

通过serverTimezone配置连接的属性,即在url中添加serverTimezone=UTC参数。

另外,serverTimezone的值除了UTC外,还可以设置Asia/ShanghaiGMT%2b8(URL编码),把会话(也就是客户端与服务器的链接)的时区设置为东八区。

String url = "jdbc:mysql://localhost:3306/crashcourse?serverTimezone=Asia/Shanghai
JDBC的会话时区如果不配置,默认使用服务器的全局时区配置。 上述配置虽然不会报错,但是不会发挥作用。如果想要时区发挥作用还需要配置useTimezone参数。正确做法是 String url = "jdbc:mysql://localhost:3306/crashcourse?serverTimezone=Asia/Shanghai&useTimezone=true

关于serverTimezone取值的格式:https://dev.mysql.com/doc/connector-j/8.0/en/connector-j-connp-props-datetime-types-processing.html

serverTimezone 只在客户端发挥作用,并不实际修改会话time_zone的值
例如,

JVM Connecter serverTimezone utc+9 server utc+8 底层
UTC+8 8 -9 utc+1

解决方案三:使用低版本驱动程序

我觉得,严格来说,这不算是问题的解决方法,而是逃避问题的手段。如果你不想了解时区是什么及如何设置,像快点学习JDBC开发技术,这也是一种选择。但是,可能会存在软件版本之间的兼容问题。

由于mysql的java驱动程序,在版本6.0.0及以上,才要求必须配置时区,因此,可以使用6.0.0以下版本的mysql-connector-java.jar,例如、比较稳定的版本5.1.49


至此问题已经解决。网上大部分的解答也差不多就是上面总结的情况。

但是,当我查看一些高赞博文的评论时,发现有人和我存在一样的困惑:”时区是什么,为什么会有时区问题?“
在这里插入图片描述

如果你也有这样的疑惑,请继续阅读下面的讲解。说实话,解决这个问题,两分钟都不需要,但是真正弄清楚问题的原因,需要花费很大努力。难能可贵嘛,加油,奥利给!


三、问题分析

”The server time zone value ‘�й���׼ʱ��’ is unrecognized“,服务器时区值’�й���׼ʱ��’是无法识别的,那么,这个乱码的值是什么?如果解决了乱码问题,是否就不会出现这个问题了呢?这是我遇到这个问题时,脑海里最初的想法。

介绍上述内容需要了解一些基础知识。

1. 时区系统变量

服务器系统变量(system variables),表示服务器运行中使用到配置选项。例如,配置服务器的端口号、字符集等等。可以在my.ini文件中配置,有些系统变量是动态的(dynamic),也可以在运行时使用SET 语句更改,这使你能够修改服务器的配置项而无需重启,即可生效。另外,全局系统变量(global system variables)对与所以会话(指的是一个mysql客户端到服务器的连接)都生效,会话系统变量(session system variables)只对当前会话有效,不影响其他会话。

和时区相关的系统变量:

  • 服务器系统时区。当服务器启动时,它会尝试确定主机的时区并使用它来设置 system_time_zone系统变量。
  • 服务器当前时区。全局 time_zone系统变量表示服务器当前运行的时区。初始time_zone 值为’SYSTEM’,表示服务器时区与系统时区相同。

如果设置为SYSTEM,(每个需要时区计算的 MySQL 函数调用)都会调用系统库来确定当前系统时区。

注意,两者的区别,服务器系统时区和我们的客户端程序(例如,JDBC程序)没有直接关系,而服务器当前时区是与我们的客户端程序有密切关系,我们使用的时区就是服务器当前时区。就好像character_set_server和character_set_system一样,system的编码用于服务器系统内部的编码,而server才和数据库的编码有联系。因此,会着重介绍服务器当前时区time_zone

设置全局系统变量语法:

全局系统变量,对所有会话有效,如果会话不覆盖系统变量,默认使用它

SET GLOBAL time_zone = timezone;

设置会话系统变量语法:

SET [SESSION | LOCAL | 省略] time_zone = timezone;

timezone值可以以多种格式给出,但都不区分大小写:

  • ‘SYSTEM’,表示服务器时区与系统时区相同。

  • 作为表示与 UTC 格式的偏移量的字符串 ,以or 为前缀,例如, 或。对于小于 10 的小时值,可以选择使用前导零;MySQL 在这种情况下存储和检索值时会添加前导零。MySQL 将 或转换为 . [H]H:MM±’+10:00’‘-6:00’‘+05:30’‘-00:00’‘-0:00’‘+00:00’在 MySQL 8.0.19 之前,这个值必须在 到 的范围内 ‘-12:59’,’+13:00’包括在内;从 MySQL 8.0.19 开始,允许的范围是’-13:59’to ‘+14:00’,包括在内。

  • 作为命名时区,例如 ‘Europe/Helsinki’、 ‘US/Eastern’、‘MET’或’UTC’。

查看系统变量语法:

SELECT @@GLOBAL.variableName;
SELECT @@SESSION.variableName;

variableName表示变量的名字,如果像查询时区系统变量,可以SELECT @@SESSION.time_zone;

另外,如果不知道变量的具体名字,也可以模糊查询

show variables like ‘匹配的条件字符串’;

2. 乱码的内容是什么

首先,使用root用户登录到服务器,执行代码:show variables like '%time_zone';

在这里插入图片描述
根据已有的知识,system_time_zone的时区值应该与我主机(windows10系统, 时区东八区,China Standard Time 中国标准时间。每个时区为了方便自己国际使用,都有一个名字。)的时区一致才对,然而这里显示的是空值。其实是有值的,mysql客户端对于乱码字符的处理方式有时候是选择不显示它。

执行代码: select @@global.system_time_zone;
发现果然是有值的,只是乱码而已
在这里插入图片描述
执行代码:set character_set_results = ‘utf8mb3’; 设置结果集编码后,在查看系统变量,发现值为"中国标准时间",这就与上文的介绍一致了。
至于,为什么设置编码为utf8mb3,这部分内容比较复杂,我会单独写一篇文章介绍。

在这里插入图片描述
前文介绍了,system_time_zone是和我们的客户端(JDBC程序)是无关的,如果JDBC没有设置会话的时区,默认使用全局的时区配置,也就是time_zone,上文也提到了,如果设置为’SYSTEM’,那么time_zone的时区是需要调用msyql的库函数获取的。我们的JDBC程序就是调用了msyql的库函数,返回值为“中国标准时间”。

至此,我们清楚了乱码的内容是“中国标准时间”。

对此,你也许会产生怀疑,我说JDBC程序就是调用了msyql的库函数,返回值为“中国标准时间”,实际底层是这样做的吗?如何能直接说明乱码就是“中国标准时间”呢。我来证明一下。

执行代码:select hex(@@global.system_time_zone);

hex()获取表中字符数据项目的在数据库表中的底层编码,可以看到返回值为:
(其实这是GBK编码的字符)。

(关于字符编码及乱码问题,可以参考这篇文章:《字符编码及乱码》,可以解决你日常遇到的所有乱码问题)

在这里插入图片描述
然后,我们使用解码工具,解码该字符编码

请添加图片描述
底层编码是GBK,但是mysql服务器却认为他是utf8mb3的,因此,必须声明解码类型为utf8mb3,而实际使用GBK解码。mysql提供的客户端程序可以做到这一点,上文中我们也看到了。但是我们的JDBC程序客户端,不可能做到这一点。因此,无法通过指定正确的编码来解决乱码问题。

3. 为什么要使用时区

先简单了解一下时区,全球被划分为24个时区,每差一个时区,区时相差一个小时。时区转换规则,“东加西减”。

例如、中国在东八区,日本在东九区,我现在的时间是22:30,那么日本现在是23:30。

在这里插入图片描述

时区表示方式:

  • UTC偏移量±[hh]:[mm]

  • 命名表示方式,例如东八区,可以使用名字China Standard Time (或者缩写CST,中国标准时间)

当然,从上图我们也可以知道,不同的国家或者地区可以处于相同的时区,为了方便使用,不同国家或地区可以根据自己的需要对相同时区定义不同的名字。例如、我们中国定义东八区为China Standard Time,中国台湾定义东八区为Taipei Standard Time。

(Windows10系统,通过在命令行窗口运行命令:tzutil /l 可以查看系统支持的时区)
在这里插入图片描述
我们对什么是时区有了初步的认识,下面说明使用时区的好处。

假设,我们建立了一个发布国际新闻的网站,首先建立一张表保存新闻信息,content字段存储新闻的内容,instant字段存储发布新闻的时间。

CREATE TABLE news(
	id INT UNSIGNED PRIMARY KEY,
	content VARCHAR(255) NOT NULL,
	instant TIMESTAMP NOT NULL
)

为了避免混乱,可以打开两个命令行窗口。

一位中国记者上传了一条新闻,设置了会话时区为东八区,然后上传了一条新闻

在这里插入图片描述
一位日本记者上传了一条新闻,设置会话时区为东九区,然后上传了一条新闻。

在这里插入图片描述

中国新闻媒体会这样报道新闻:
(注意,time_zone在会话期间,只需设置一次,我这里是为了体现命令所在的时区,因此每次执行命令,先设置时区)
在这里插入图片描述

  1. 4月4日,23点4分,震惊!某程序员晚上不睡觉,竟然为了这件事!
  2. 北京时间(中国标准时间),4月4日,23点5分,日本发生7.5级地震(原日文:日本でマグニチュード7.5の地震が発生)

在这里插入图片描述
设置时区后,当存储或者检索时间类型数据的时候会进行转换,依据时区设置。如果没有时区设置,那么,中国新闻媒体看到的日本记者发布的新闻时间是4月5日,0点5分。

4. 如何在mysql驱动程序中设置时区

请参考文章【mysql中的时区问题】

Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐