RuoYi-Cloud 3.6.8 本地启动指南（Windows）

项目地址：https://gitee.com/y_project/RuoYi-Cloud.git
分支：master（Spring Boot 4.x，需 JDK 17+）
文档更新：2026-05-28

一、环境要求

组件	推荐版本	说明
JDK	17（或 21）	master 分支必须 17+，不要用 JDK 8
Maven	3.8+	IDEA 自带或独立安装
MySQL	5.7 / 8.0	root 密码示例：`123456`
Redis	任意稳定版	本地无密码，`6379`
Nacos	3.0.2	不要用 3.2+ 除非熟悉新控制台；下载：https://github.com/alibaba/nacos/releases/download/3.0.2/nacos-server-3.0.2.zip
Node.js	16.20.2 LTS	跑 `ruoyi-ui` 前端，不要用 Node 20+
IDEA	2023+	SDK 选 JDK 17

JDK 8 毕设场景：换 springboot2 分支 + Nacos 2.x，不要继续用 master。

二、端口规划

服务	端口	访问地址
Nacos API	8848	微服务注册/配置
Nacos 控制台	8080	http://127.0.0.1:8080
若依网关	8088	http://127.0.0.1:8088（避免与 Nacos 控制台冲突）
ruoyi-auth	9200
ruoyi-system	9201
ruoyi-gen	9202	可选
ruoyi-job	9203	可选
ruoyi-file	9300	可选
ruoyi-monitor	9100	可选
Redis	6379
MySQL	3306
前端 ruoyi-ui	80	http://localhost

三、数据库初始化

SQL 文件位置：项目根目录/sql/

文件	数据库	作用
`ry_config_20260311.sql`	`ry-config`	Nacos 配置（自动建库）
`ry_20260417.sql`	`ry-cloud`	业务表 + 初始数据
`quartz.sql`	`ry-cloud`	定时任务表
`ry_seata_20210128.sql`	`ry-seata`	可选，分布式事务

3.1 删除并创建数据库

cd /d C:\path\to\RuoYi-Cloud\sql

mysql -uroot -p123456 -e "DROP DATABASE IF EXISTS `ry-cloud`; CREATE DATABASE `ry-cloud` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; DROP DATABASE IF EXISTS `ry-config`; CREATE DATABASE `ry-config` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"

3.2 导入 SQL

mysql -uroot -p123456 < ry_config_20260311.sql
mysql -uroot -p123456 ry-cloud < ry_20260417.sql
mysql -uroot -p123456 ry-cloud < quartz.sql

3.3 修改 MySQL 密码（Nacos 配置里默认是 password）

mysql -uroot -p123456 -e "USE `ry-config`; UPDATE config_info SET content = REPLACE(content, 'password: password', 'password: 123456') WHERE content LIKE '%password: password%';"

3.4 网关端口 8080 → 8088（SQL 批量改）

mysql -uroot -p123456 -e "USE `ry-config`; UPDATE config_info SET content = REPLACE(content, 'http://localhost:8080', 'http://localhost:8088') WHERE content LIKE '%http://localhost:8080%';"

mysql -uroot -p123456 -e "USE `ry-cloud`; UPDATE sys_menu SET path = REPLACE(path, 'http://localhost:8080', 'http://localhost:8088') WHERE path LIKE '%localhost:8080%';"

3.5 默认登录账号

用户名：admin
密码：admin123

四、Nacos 配置与启动

安装路径示例：D:\Java\nacos-server-3.0.2\nacos

4.1 修改 `conf/application.properties`

MySQL 连接（必改，否则用内置库读不到若依配置）：

spring.sql.init.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/ry-config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=Asia/Shanghai
db.user.0=root
db.password.0=123456

鉴权（不能为空，否则启动报错）：

nacos.core.auth.enabled=false
nacos.core.auth.admin.enabled=false
nacos.core.auth.console.enabled=false
nacos.core.auth.server.identity.key=serverIdentity
nacos.core.auth.server.identity.value=security
nacos.core.auth.plugin.nacos.token.secret.key=SecretKey012345678901234567890123456789012345678901234567890123456789

启动时若提示输入 token/identity，不要直接回车，先在配置文件里写好。

4.2 启动命令

cd /d D:\Java\nacos-server-3.0.2\nacos\bin
startup.cmd -m standalone

停止：

shutdown.cmd

4.3 验证

控制台：http://127.0.0.1:8080
配置管理 → 配置列表 应有：application-dev.yml、ruoyi-gateway-dev.yml、ruoyi-system-dev.yml 等
日志不应长期只有 embedded storage（应连 MySQL）

五、Redis

无密码、本机默认即可，Nacos 配置里已是：

spring:
  data:
    redis:
      host: localhost
      port: 6379
      password:

验证：redis-cli ping → PONG

六、网关与前端端口修改

6.1 网关 `bootstrap.yml`

文件：ruoyi-gateway/src/main/resources/bootstrap.yml

server:
  port: 8088

6.2 前端代理 `vue.config.js`

文件：ruoyi-ui/vue.config.js

target: `http://localhost:8088`,

七、启动顺序（重要）

第一层：基础设施

MySQL 服务
Redis 服务
Nacos（startup.cmd -m standalone）

第二层：后端微服务（IDEA 依次 Run）

顺序	模块	启动类	端口
1	ruoyi-gateway	`RuoYiGatewayApplication`	8088
2	ruoyi-auth	`RuoYiAuthApplication`	9200
3	ruoyi-system	`RuoYiSystemApplication`	9201

最少启动以上 3 个 + 网关，才能登录。

第三层：可选模块

模块	启动类	端口
ruoyi-gen	`RuoYiGenApplication`	9202
ruoyi-job	`RuoYiJobApplication`	9203
ruoyi-file	`RuoYiFileApplication`	9300
ruoyi-monitor	`RuoYiMonitorApplication`	9100

第四层：前端

cd ruoyi-ui
npm install
npm run dev

浏览器：http://localhost
登录：admin / admin123

八、IDEA 配置要点

File → Project Structure → SDK → JDK 17
用 Maven 打开根目录 pom.xml，等待依赖下载
安装 Lombok 插件（如提示）
每个服务 Active profiles：dev（bootstrap.yml 默认已是 dev）
首次建议：Maven → 根项目 → install（可跳过测试）

九、启动后自检

检查项	方法
Nacos 服务注册	控制台 → 服务管理，应有 gateway、auth、system
网关	访问 http://127.0.0.1:8088
前端登录	http://localhost ，admin / admin123
MySQL	`USE ry-cloud; SELECT user_name FROM sys_user;`
Redis	`redis-cli ping`

十、常见问题

现象	原因	处理
Nacos 启动报 Empty identity	token/identity 为空	按第四节填写鉴权三项
Nacos 配置列表为空	未连 MySQL	配置 `db.url.0` 指向 `ry-config`，删 `data` 目录后重启
服务连不上数据库	Nacos 里密码仍是 password	执行 3.3 节 SQL 或控制台手动改
8080 端口冲突	Nacos 控制台与网关同端口	网关改 8088，见第六节
npm install 失败	Node 版本过高	换 Node 16.20.2
Sentinel 8718 警告	未装 Sentinel	可忽略，不影响登录
文件上传失败	目录不存在	创建 `D:/ruoyi/uploadPath` 或改 Nacos 里 `ruoyi-file-dev.yml`

十一、架构示意

浏览器 → ruoyi-ui(:80)
           ↓ 代理 /dev-api
        ruoyi-gateway(:8088)
           ↓
    ┌──────┼──────┬─────────┐
    ↓      ↓      ↓         ↓
  auth  system  gen      job ...
 (:9200)(:9201)(:9202)  (:9203)
    └──────┴──────┴─────────┘
           ↓
    MySQL(ry-cloud)  Redis  Nacos(:8848/8080)