前端视角：从零搭建并启动若依后端环境

前言

作为前端开发，因前后端联调需求需启动若依 Java 后端，本文记录从环境准备到后端启动的完整流程，适配本地已有 JDK17（安卓项目）、MySQL8.0（Node 后端）的场景，全程不破坏原有开发环境。

一、环境准备（核心：不卸载原有环境，按需适配）

若依官方推荐

JDK >=1.8(推荐 1.8 版本) Mysql >=5.7.0 (推荐 5.7 版本) Maven >=3.0 Redis >=5.0 非官方推荐 

安装开发工具（推荐 IntelliJ IDEA 社区版）

• 作用：打开、编译、运行 Java 代码的工具，比记事本 / VS Code 更友好。
• 下载地址：IDEA 官网（选 Community 社区版，免费）。
• 安装：一路下一步，安装时勾选'Add launchers dir to PATH'（添加到环境变量）。

1. JDK 环境配置（若依需 JDK1.8，保留 JDK17 供安卓使用）

• 现状：本地已有 JDK1.8.0_361、JDK17、JDK19，JDK17 用于安卓项目（若没有 JDK，需下载安装）
• 官方：Oracle JDK8（可能需要注册，略麻烦）
• 非官方：OpenJDK 8（免费无需注册）
• 配置方式（IDEA 内隔离配置，不修改全局环境）：
  1. 打开 IDEA → File → Project Structure（Ctrl+Alt+Shift+S）；
  2. 左侧 Platform Settings → SDKs → 点击 + → Add SDK → Java，选择本地 C:\Program Files\Java\jdk1.8.0_361；
  3. 左侧 Project Settings → Project，Project SDK 选 1.8 (jdk1.8.0_361)，Project language level 选 8 - Lambdas, type annotations etc.；

验证：启动项目后，IDEA 运行日志中出现 C:\Program Files\Java\jdk1.8.0_361\bin\java.exe 即配置生效（验证版本时无需关注 Terminal 的 java -version 显示 JDK17）。

项目启动，点击 RuoYiApplication 文件右键：

2. Redis 安装与配置（若依>=3.0）

• 下载：Windows 版 Redis（推荐 5.0.14.1，解压至 D:\Redis-x64-5.0.14.1，无中文/空格路径）；
• 启动：
  1. 管理员身份运行 redis-server.exe redis.windows.conf（保持窗口打开）；
  2. 验证：新开 CMD 执行 redis-cli.exe → 输入 ping 返回 PONG 即正常；
• 若依配置：无需修改 application.yml 中 Redis 默认配置（host=localhost、port=6379、无密码）；

常见问题：持久化权限报错（MISCONF Redis is configured to save RDB snapshots），解决（主要是权限问题，需管理员权限打开 Redis）：

# 进入 redis-cli 执行 config set stop-writes-on-bgsave-error no 

3. Maven 配置（若依>=3.0）

• 下载地址：Maven 官网（选类似 apache-maven-3.6.3-bin.zip 的包）；
• 解压到非中文路径（比如 D:\Maven）；
• 配置环境变量：新建 MAVEN_HOME = 解压路径，Path 新增 %MAVEN_HOME%\bin；
• 验证：IDEA 终端执行 mvn -v，确保版本≥3.0；
• 优化配置（加快依赖下载）：
  1. IDEA 中配置：File → Settings → Build Tools → Maven，指定 Maven home directory 和修改后的 settings.xml。

找到 Maven 安装目录 conf/settings.xml，在 <mirrors> 内添加阿里云镜像：

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

4. MySQL 配置（适配本地 8.0.43，无需降级 5.7）

• 没有数据库的可提前进行下载安装，官方网址：MySQL 下载安装后，管理员权限进入命令提示符（CMD），启动数据库

net start mysql
mysql -u 用户名 -p
# 用户名一般是 root

• 导入 SQL 脚本（可视化工具执行，避免命令行路径问题）：
  1. 切换至 ruoyi_admin 库；

若依连接配置（修改 application-druid.yml）：

spring:
  datasource:
    druid:
      master:
        url: jdbc:mysql://localhost:3306/ruoyi_admin?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
        username: root # 本地 MySQL 用户名
        password: 123456 # 本地 MySQL 密码
        driver-class-name: com.mysql.cj.jdbc.Driver # 8.0 专属驱动

导入若依 sql 目录下的 ry_20250522.sql 和 quartz.sql；

新建若依专属库（隔离 Node 后端数据）：

CREATE DATABASE IF NOT EXISTS ruoyi_admin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

二、启动若依后端

1. 启动 Redis（管理员身份运行 redis-server.exe）；
2. 打开 IDEA，加载若依后端代码；
3. 找到启动类 RuoYiApplication.java，右键→Run 'RuoYiApplication'；
4. 验证启动成功：
   • IDEA 日志无红色报错，最终显示 Started RuoYiApplication in XX seconds；
   • 浏览器访问 http://localhost:8080，出现若依登录页。

三、前后端联调最后一步

修改若依前端项目 .env.development 文件：

VUE_APP_BASE_API = 'http://localhost:8080'

启动前端（npm run dev），即可正常访问登录页并联调。

四、关键注意事项

1. JDK：仅在 IDEA 内为若依配置 JDK1.8，全局保留 JDK17，不影响安卓项目；
2. MySQL：8.0 需修改驱动类为 com.mysql.cj.jdbc.Driver，URL 补充 allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true；
3. Redis：必须管理员启动，避免持久化权限报错；
4. 路径：所有安装目录（JDK/Redis/Maven/若依代码）避免中文/空格，防止解析错误。