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

前言

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

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

若依官方推荐

bash 复制代码

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.；
4. 验证：启动项目后，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）：
Plain 复制代码
```
# 进入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. 找到Maven安装目录conf/settings.xml，在<mirrors>内添加阿里云镜像：
  XML 复制代码
```
<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>
```
2. IDEA中配置：File → Settings → Build Tools → Maven，指定Maven home directory和修改后的settings.xml。

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

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

bash 复制代码

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

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

SQL 复制代码

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

导入SQL脚本（可视化工具执行，我用的是HeidiSQL，避免命令行路径问题）：
1. 切换至ruoyi_admin库；
2. 导入若依sql目录下的ry_20250522.sql和quartz.sql；

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

代码

YAML 复制代码

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专属驱动

二、启动若依后端

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

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

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

Plain 复制代码

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