若依微服务版（RuoYi-Cloud）本地启动全攻略

若依微服务版（RuoYi-Cloud）本地启动全攻略

若依微服务版（RuoYi-Cloud）是基于Spring Cloud Alibaba构建的开源微服务脚手架，本文从源码下载→环境准备→数据库初始化→中间件部署→项目配置→服务启动→问题排查 全流程讲解本地启动方法，适配若依Cloud 3.6.x版本，解决新手常见的数据库、Nacos连接、依赖兼容等问题。

一、核心前提：版本匹配（避坑关键）

若依微服务版对组件版本要求严格，版本不匹配会导致启动失败，以下是经过验证的兼容版本清单：

组件/软件	推荐版本	备注
JDK	1.8（1.8.0_200+）	核心运行环境，JDK17兼容差
Maven	3.6.0+	项目构建工具
MySQL	5.7.x / 8.0.x	8.0需注意驱动和加密方式
Redis	5.0+ / 6.0+	缓存中间件，默认端口6379
Nacos	2.0.4	注册/配置中心，2.2.0兼容差
Sentinel	1.8.6	流量控制，默认端口8080
Seata	1.5.2	分布式事务，默认端口8091
Node.js	14.x / 16.x（LTS）	前端构建，避免高版本兼容问题

二、第一步：拉取若依微服务源码

先获取源码，后续的数据库脚本、配置文件均来自源码包，是所有操作的基础。

gitee上面的下载地址（后端）：https://gitee.com/y_project/RuoYi-Cloud

gitcode上面的下载地址（前端）：https://gitcode.com/yangzongzhuan/RuoYi-Cloud-Vue3 （推荐前端使用vue3）

获取好项目如下，需要注意的点是我这个是把后端里面的ruoyi-ui删除了这个是vue2的然后现在下载了vue3版本的前端是RuoYi-Cloud-Vue3：

三、第二步：数据库初始化（依赖源码脚本）

MySQL是核心存储，需先创建数据库并执行源码中的初始化脚本：

3.1 安装并启动MySQL

安装MySQL 5.7/8.0版本，启动MySQL服务，确保3306端口可访问，记住root账号密码（后续配置用）。

3.2 创建数据库并执行脚本

1. 打开MySQL客户端（Navicat/命令行），创建3个核心数据库：
   • ry-cloud（主业务库，必建）执行ry_202xxxx.sql
   • ry-config（Nacos持久化库）执行ry_config_202xxxx.sql
   • ry-seata（Seata分布式事务库，可选）
2. 执行源码sql目录下的脚本：
   • 必执行：ry_202xxxx.sql（主业务表）、ry_config_202xxxx.sql（配置库表）；
   • 可选：seata/mysql.sql（Seata事务表）、quartz.sql（定时任务表）；

四、第三步：中间件部署（按顺序启动）

中间件是微服务运行的基础，需按以下顺序部署（先依赖后服务）：

4.1 Redis部署（缓存中间件）

安装好Redis 5.0+/6.0+版本，然后按照下面执行；

redis-server.exe redis.windows.conf

有上图及是启动成功了。

4.2 Nacos部署（注册/配置中心，核心）

Nacos是微服务的“大脑”，必须以单机模式启动，否则会因集群配置缺失启动失败。

4.2.1 下载与解压（GitHub地址，可以无法下载这个链接，需要自己找到一个Nacos）

下载地址：Nacos 2.0.4 官方包，解压到本地（路径不要有中文/空格）。

4.2.2 修改Nacos的配置

4.2.3启动（单机启动）

启动成功样式：

4.2.4 验证配置是否正确

访问控制台：http://127.0.0.1:8848/nacos，默认账号/密码：nacos/nacos，能登录即启动成功。

五、项目配置修改（核心）

打开Nacos然后修改配置

六、第五步：服务启动

检查启动的中间件

确保Redis和Nacos的启动。

启动后端项目

前端启动

安装依赖

pnpm install

运行

pnpm run dev