若依微服务版（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 创建数据库并执行脚本
- 打开MySQL客户端（Navicat/命令行），创建3个核心数据库：
ry-cloud（主业务库，必建）执行ry_202xxxx.sqlry-config（Nacos持久化库）执行ry_config_202xxxx.sqlry-seata（Seata分布式事务库，可选）
- 执行源码
sql目录下的脚本：- 必执行：
ry_202xxxx.sql（主业务表）、ry_config_202xxxx.sql（配置库表）； - 可选：
seata/mysql.sql（Seata事务表）、quartz.sql（定时任务表）；
- 必执行：
四、第三步：中间件部署（按顺序启动）
中间件是微服务运行的基础，需按以下顺序部署（先依赖后服务）：
4.1 Redis部署（缓存中间件）
安装好Redis 5.0+/6.0+版本，然后按照下面执行；
bash
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的启动。
启动后端项目
前端启动
安装依赖
bash
pnpm install运行
bash
pnpm run dev