前端视角 | 从零搭建并启动若依后端(环境配置)

前言

作为前端开发，因前后端联调需求需启动若依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脚本（可视化工具执行，我用的是HeidiSQL，避免命令行路径问题）：
  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，出现若依登录页，提示通过前端UI访问。

三、前后端联调最后一步（最拿手的）

修改若依前端项目.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/若依代码）避免中文/空格，防止解析错误。