前端视角 | 从零搭建并启动若依后端(环境配置)
前言
作为前端开发,因前后端联调需求需启动若依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内隔离配置,不修改全局环境):
- 打开IDEA →
File→Project Structure(Ctrl+Alt+Shift+S); - 左侧
Platform Settings→SDKs→ 点击+→Add SDK→Java,选择本地C:\Program Files\Java\jdk1.8.0_361; - 左侧
Project Settings→Project,Project SDK选1.8 (jdk1.8.0_361),Project language level选8 - Lambdas, type annotations etc.;
- 打开IDEA →
验证:启动项目后,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,无中文/空格路径); - 启动:
- 管理员身份运行
redis-server.exe redis.windows.conf(保持窗口打开); - 验证:新开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; - 优化配置(加快依赖下载):
- IDEA中配置:
File→Settings→Build Tools→Maven,指定Maven home directory和修改后的settings.xml。
- IDEA中配置:
找到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,避免命令行路径问题):
- 切换至
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; 二、启动若依后端
- 启动Redis(管理员身份运行
redis-server.exe); - 打开IDEA,加载若依后端代码;
- 找到启动类
RuoYiApplication.java,右键→Run 'RuoYiApplication'; - 验证启动成功:
- IDEA日志无红色报错,最终显示
Started RuoYiApplication in XX seconds; - 浏览器访问
http://localhost:8080,出现若依登录页,提示通过前端UI访问。
- IDEA日志无红色报错,最终显示
三、前后端联调最后一步(最拿手的)
修改若依前端项目.env.development文件:
VUE_APP_BASE_API = 'http://localhost:8080' 启动前端(npm run dev),即可正常访问登录页并联调。
四、关键注意事项
- JDK:仅在IDEA内为若依配置JDK1.8,全局保留JDK17,不影响安卓项目;
- MySQL:8.0需修改驱动类为
com.mysql.cj.jdbc.Driver,URL补充allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true; - Redis:必须管理员启动,避免持久化权限报错;
- 路径:所有安装目录(JDK/Redis/Maven/若依代码)避免中文/空格,防止解析错误。