一、启动若依后端完整流程（前端友好版）
| 步骤 | 操作内容 | 注意事项 |
|---|---|---|
| 1 | 启动Redis | 双击已创建的"管理员身份"Redis快捷方式（redis-server.exe），保持窗口打开 |
| 2 | 启动MySQL | 确认本地MySQL服务已启动（可通过任务管理器→服务→MySQL80，确保状态为"正在运行"） |
| 3 | 打开IDEA | 直接打开若依后端项目（无需重新配置JDK/Maven，IDEA会保留之前的配置） |
| 4 | 启动若依后端 | 找到RuoYiApplication.java，右键→Run 'RuoYiApplication'（或点击IDEA顶部的运行按钮） |
| 5 | 验证后端启动 | 访问http://localhost:8080，能看到登录页即成功 |
| 6 | 启动前端 | 前端项目执行npm run dev，修改请求地址为http://localhost:8080 |
二、常用命令（带注释）
1. Redis相关命令
| 命令 | 作用 | 执行场景 |
|---|---|---|
redis-cli.exe |
进入Redis命令行 | 验证Redis是否正常/执行配置修改 |
ping |
验证Redis连接（返回PONG则正常） | 启动Redis后快速验证 |
config set stop-writes-on-bgsave-error no |
关闭Redis持久化写保护 | 出现Redis持久化权限报错时 |
redis-server.exe redis.windows.conf |
启动Redis服务（管理员身份） | 每日启动第一步 |
2. Maven相关命令（IDEA终端执行）
| 命令 | 作用 | 执行场景 |
|---|---|---|
mvn -v |
验证Maven版本 | 检查Maven是否安装成功 |
mvn clean install -DskipTests |
下载依赖并编译项目 | 首次启动/依赖更新后 |
mvn spring-boot:run |
运行若依后端（替代IDEA手动启动） | 无IDEA时的备用启动方式 |
mvn clean compile |
清理并编译代码 | 代码修改后重新编译 |
3. MySQL相关命令
| 命令 | 作用 | 执行场景 |
|---|---|---|
mysql -u root -p |
登录MySQL命令行 | 验证MySQL连接/执行简单SQL |
USE ruoyi_admin; |
切换到若依数据库 | 导入脚本/查看表结构前 |
SHOW TABLES; |
查看若依数据库表 | 验证SQL脚本是否导入成功 |
三、常见错误及解决方案
| 错误现象 | 核心原因 | 解决方案 |
|---|---|---|
前端报错：MISCONF Redis is configured to save RDB snapshots |
Redis权限不足，持久化失败触发写保护 | 1. 管理员启动Redis； 2. 进入redis-cli执行config set stop-writes-on-bgsave-error no |
IDEA日志：Access denied for user 'root'@'localhost' |
MySQL密码错误/用户名错误 | 修改application-druid.yml中的username/password为本地MySQL正确信息 |
IDEA日志：Unknown database 'ruoyi_admin' |
若依数据库名配置错误/库未创建 | 1. 确认MySQL中已创建ruoyi_admin库； 2. 检查application-druid.yml中的库名是否匹配 |
IDEA日志：ClassNotFoundException: com.mysql.cj.jdbc.Driver |
MySQL驱动类配置错误（8.0用了5.7的驱动） | 修改application-druid.yml中driver-class-name为com.mysql.cj.jdbc.Driver |
IDEA终端java -version显示JDK17，但项目启动正常 |
IDEA终端继承全局JDK，项目实际用JDK1.8 | 无需处理，以项目启动日志中的java.exe路径为准 |
若依启动报错：Address already in use |
8080端口被占用 | 修改application.yml中server.port为8081，重启后端 |
| Maven依赖下载失败 | 镜像配置错误/网络问题 | 1. 检查Maven的阿里云镜像配置； 2. 删除~/.m2/repository目录后重新执行mvn clean install |
四、日常维护小技巧
-
关闭电脑前：无需额外操作，直接关机（Redis/MySQL/IDEA会自动停止，若依数据已持久化到MySQL）；
-
重启后Redis报错：优先检查是否以管理员身份启动；
-
若依登录失败（账号admin/密码admin123）：检查MySQL是否启动、若依数据库是否导入成功、Redis是否正常；
-
依赖下载慢：确保Maven已配置阿里云镜像，且网络正常。