ruoyi项目更换为mysql9.7.0数据库

将 RuoYi 项目更换为 MySQL 9.7.0(注:目前 MySQL 官方最新稳定版为 9.3.0,9.7.0 可能为特定分支或笔误,但配置方式通用),核心在于升级 JDBC 驱动调整数据库连接配置,因为 MySQL 9.x 彻底移除了旧版认证插件支持。

一键安装完成MySQL9.7.0 http://www.zrscsoft.com/sitepic/12179.html

若依ruoyi开源项目快速搭建指南http://www.zrscsoft.com/sitepic/12165.html

主要步骤如下:

1. 升级 Maven 依赖(关键)

MySQL 9.x 必须使用新版驱动(com.mysql.cj.jdbc.Driver),且建议依赖版本至少在 8.0.30 以上,最好直接使用 9.x 的驱动以获得最佳兼容性和新特性支持。

打开父工程或 ruoyi-admin模块的 pom.xml,修改 MySQL 连接器依赖:

复制代码
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>9.0.0</version> <!-- 或 8.0.33 等较新版本 -->
</dependency>

注意:旧版的 mysql-connector-javagroupId 已变更为 com.mysql,且 9.x 版本 artifactId 通常为 mysql-connector-j

2. 修改数据源配置

编辑 ruoyi-admin/src/main/resources/application-druid.yml(若依传统架构)或对应的 application.yml

  • driverClassName :确保为 com.mysql.cj.jdbc.Driver(MySQL 8.0+ 标准,5.7 的旧驱动类名已不适用)。

  • URL 参数 :MySQL 9.x 默认认证插件为 caching_sha2_password,建议在 URL 中显式加上 allowPublicKeyRetrieval=true,并设置时区(如 serverTimezone=Asia/Shanghai),否则可能出现认证或时区报错。

    spring:
    datasource:
    driverClassName: com.mysql.cj.jdbc.Driver
    druid:
    master:
    url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root
    password: 你的密码

3. 数据库初始化

MySQL 9.x 对 SQL 语法的校验更严格,但 RuoYi 官方提供的 ry_*.sql脚本通常基于 MySQL 5.7+/8.0+ 编写,一般可直接在 9.x 中执行。

  • 先创建数据库(建议字符集 utf8mb4):

    复制代码
    CREATE DATABASE ry_vue DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
  • 然后导入 RuoYi 自带的 SQL 文件(如 ry_202xxxxx.sqlquartz.sql)。

常见坑点提示

  • 如果启动时报"Authentication plugin 'caching_sha2_password' cannot be loaded",通常是驱动版本过低,请务必完成第 1 步的驱动升级。

  • 若原来使用的是 MySQL 5.7 且表名含特殊大小写,需注意 MySQL 9 默认的系统变量 lower_case_table_names设置,Linux 下默认区分大小写,与 Windows 不同。

相关推荐
天桥下的卖艺者3 小时前
使用scitable包,两步生成逆概率删失权重(IPCW)
数据库·r语言
隔窗听雨眠3 小时前
AI原生数据库浪潮:国产数据库的架构重构与路径之争
数据库
数据库小学妹3 小时前
数据库选型实战:从数据类型到TCO成本,五维决策框架+九款产品横评
数据库·信创·国产数据库·数据库选型·oracle迁移
神龙天舞20014 小时前
MySQL 备库为什么会延迟好几个小时
android·数据库·mysql
丙氨酸長鏈6 小时前
Web前端入门第 问:JavaScript 一个简单的 IndexedDB 数据库入门示例
前端·javascript·数据库
独行侠影a6 小时前
APScheduler+Redis 分布式定时任务:解决多实例任务重复执行
数据库·redis·分布式
传说故事7 小时前
数据库中一些常用英文单词含义
数据库·oracle
夏贰四7 小时前
中小企业搭建业务中台如何控成本?业务中台轻量化落地分几步实施?
数据库·业务中台
林焱RPA7 小时前
影刀RPA200篇纪念版:最实用的20个自动化场景大盘点
数据库
名字还没想好☜7 小时前
Go 的 time.After 在 select 循环里内存泄漏:定时器堆积原理与 timer.Reset 正确姿势
java·数据库·golang·go·goroutine