若依报错Server returns invalid timezone. Go to ‘Advanced‘ tab and set ‘serverTimezone‘ property manually

该报错的核心原因是MySQL 8.0+ 默认时区为 UTC（世界协调时间），与中国所在的东八区（GMT+8/Asia/Shanghai）时区不匹配，而若依的数据源配置中未手动指定serverTimezone参数，导致数据库连接时时区校验失败。

若依框架下的解决方法：修改数据源配置

若依的数据库连接配置集中在application.yml（或application-druid.yml）文件中，只需在 MySQL 连接 URL 中添加serverTimezone参数即可，步骤如下：

步骤 1：定位若依的数据源配置文件

打开若依后端项目，找到以下配置文件：

• 主配置：ruoyi-admin/src/main/resources/application.yml
• 或 Druid 专属配置：ruoyi-admin/src/main/resources/application-druid.yml

步骤 2：修改 MySQL 连接 URL，添加时区参数

找到spring.datasource.druid.url配置项，在末尾拼接&serverTimezone=Asia/Shanghai（注意：URL 开头参数用?，后续参数用&）。

错误配置示例：

spring: datasource: druid: # 无时区参数，触发报错 url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&allowMultiQueries=true username: root password: root

正确配置示例（添加serverTimezone=Asia/Shanghai）：

spring: datasource: druid: # 新增 serverTimezone 参数，指定为上海时区 url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&allowMultiQueries=true&serverTimezone=Asia/Shanghai username: root password: root

步骤 3（可选）：彻底修改 MySQL 全局时区（避免后续问题）

若不想在每个连接 URL 中加参数，可直接修改 MySQL 全局时区，永久适配东八区：

1. 登录 MySQL 客户端（如 Navicat / 命令行）：

   mysql -u root -p

2. 执行以下命令修改时区：

   -- 查看当前时区 SELECT @@global.time_zone; -- 设置全局时区为东八区 SET GLOBAL time_zone = '+8:00'; -- 刷新配置 FLUSH PRIVILEGES;

3. 重启 MySQL 服务，后续连接无需再指定serverTimezone。

步骤 4：重启若依后端服务

修改配置后，重启若依的ruoyi-admin模块，检查启动日志：

• 无「invalid timezone」报错，且能正常连接数据库（如日志显示「DruidDataSource - init success」），说明配置生效。

需要留意的地方：

1. 时区参数值推荐用Asia/Shanghai（而非GMT+8），避免部分 MySQL 版本识别异常；
2. 若依多环境配置（dev/prod）需同步修改对应环境的application-xxx.yml文件；
3. 若使用 MySQL 5.7 及以下版本，虽大概率不会触发该报错，但添加serverTimezone参数也兼容，可统一配置。