MySQL 8.0 + IntelliJ IDEA 时区错误解决方法

问题分析

在进行数据库开发时，特别是涉及时间字段的读写操作，如果 MySQL 服务器的默认时区（time_zone）与 Java 应用程序期望的时区不一致，驱动层就会抛出异常。原始报错信息如下：

org.apache.ibatis.exceptions.PersistenceException: 
### Error querying database.  Cause: java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more than one time zone...
### Cause: java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized...

其中乱码部分对应“中国标准时间”。这说明 MySQL 服务端的时区变量被读取为一个无法被 JDBC 驱动识别的字符串，导致无法建立稳定的会话连接。

服务端永久时区配置

第1步：查看当前数据库时区状态

首先确认当前的时区设置。打开终端（CMD 或 PowerShell），登录 mysql：

登录成功后，执行以下 SQL 语句查询时间变量：

show variables like "%time_zone%";

若结果显示为 SYSTEM，则表示跟随操作系统环境。虽然通常能正常工作，但在某些 Windows 环境下会产生上述的字符集与编码冲突，因此建议强制指定为标准北京时间。

第2步：临时生效修改全局时区

为了验证修复是否有效，可以先通过命令窗口尝试直接修改全局配置：

set global time_zone='+08:00';

注意：此方法仅对非 Root 用户的后续新连接生效，且重启 MySQL 服务后该设置将失效，无法一劳永逸解决问题。

第3步：配置 my.ini 实现永久生效

要实现永久更改，必须修改 MySQL 的配置文件（通常是 my.ini 或 my.cnf）：

1. 找到 MySQL 安装目录下的 my.ini 文件。
2. 在 [mysqld] 配置段内添加一行：
   default-time-zone = '+08:00'

关键点：该参数必须写在 [mysqld] 标识符下方。如果将其放在其他段落（如 [client]）或不正确的层级，启动时会报 unknown variable 错误。保存文件后，务必重启 MySQL 服务使配置加载。

JDBC 客户端连接配置修复

即使数据库端已配置完毕，在使用 IntelliJ IDEA 的 Database 插件或项目中运行代码时，仍可能因为 URL 缺少时区提示而继续报错。需要在连接参数中强制声明时区。

第4步：修正 IDEA 数据库插件配置

进入 IDEA 的 Database 视图，双击你的数据源进入属性页。在 Connection 选项卡的 URL 输入框后方，追加 JDBC 参数：

?serverTimezone=GMT%2B8

完整的 URL 示例：jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8。

填写完成后点击 Test Connection，若返回 "Connection successful" 且未再抛出时区异常，即表示完美解决。

总结

解决此类 MySQL 时区报错的核心逻辑是双管齐下：服务端通过 my.ini 锁定 +08:00 时区，客户端通过 JDBC URL 明确告知驱动预期的是东八区时间。只要保持两者的统一，即可杜绝因系统语言环境和默认环境引起的连接阻断。

以上就是解决 MySQL 8.0 + IntelliJ IDEA 时区错误的详细内容，更多关于 MySQL JDBC 时区配置的资料请关注本站其它相关文章！