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

前言

最近因为前后端联调，需要启动一个若依的Ja va后端。坦白说，作为一个前端开发者，平时跟Ja va打交道的机会并不多，但实际操练下来发现，只要把环境准备这个前置步骤梳理清楚，整个过程其实并不复杂。这篇文章就是从我的角度出发，把从零搭建到最终启动若依后端的完整流程记录下来。特别说明一下，我本地本来就有JDK17（安卓项目在用）和MySQL8.0（Node后端在用），所以整个配置的核心思路是：不卸载、不破坏已有环境，只在需要的地方做适配。

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

先说说若依官方的推荐配置

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

开发工具方面，推荐直接用 IntelliJ IDEA 社区版，免费且足够用。它比记事本或VS Code对Ja va项目的支持要友好得多。下载时选Community版本就行，安装时记得勾选“Add launchers dir to PATH”，方便后续命令行调用。

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

• 现状：本地已有JDK1.8.0_361、JDK17、JDK19，其中JDK17用于安卓项目。如果本地还没装JDK1.8，可以从Oracle官网下载（可能需要注册），或者直接用OpenJDK 8，免费且无需注册。

• 配置方式（在IDEA内做隔离配置，不修改全局环境）：

  1. 打开IDEA → File → Project Structure（快捷键Ctrl+Alt+Shift+S）；
  2. 左侧Platform Settings → SDKs → 点击+ → Add SDK → Ja va，选择本地C:Program FilesJa vajdk1.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 FilesJa vajdk1.8.0_361binja va.exe，这就说明配置生效了。注意，这时候Terminal里输入的ja va -version可能还是显示JDK17，但那只是全局环境，不影响IDE内的项目。

  项目启动时，如图所示，直接右键点击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 sa ve RDB snapshots），核心是因为权限不够，需要用管理员权限打开Redis。如果问题依旧，可以在redis-cli中执行：

  config set stop-writes-on-bgsa ve-error no

3. Ma ven配置（若依>=3.0）

• 下载地址：Ma ven官网，选类似apache-ma ven-3.6.3-bin.zip的包；

• 解压到非中文路径（比如D:Ma ven）；

• 配置环境变量：新建MA VEN_HOME=解压路径，然后在Path中新增%MA VEN_HOME%bin；

• 验证：在IDEA终端执行mvn -v，确保版本≥3.0；

• 优化配置（加快依赖下载）：

  1. 找到Ma ven安装目录下的conf/settings.xml，在内添加阿里云镜像：

  
      aliyunma ven
      central
      https://ma ven.aliyun.com/repository/public
  

  2. IDEA中配置：File → Settings → Build Tools → Ma ven，指定Ma ven home directory和修改后的settings.xml。

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

• 如果没有MySQL，需要提前下载安装。完成后，以管理员身份打开命令提示符（CMD），启动数据库：

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

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

  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）：

  

  spring:
    datasource:
      druid:
        master:
          url: jdbc:mysql://localhost:3306/ruoyi_admin?useUnicode=true&characterEncoding=utf8&zeroDateTimeBeha vior=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专属驱动

二、启动若依后端

1. 以管理员身份启动Redis（运行redis-server.exe）；
2. 打开IDEA，加载若依后端代码；
3. 找到启动类RuoYiApplication.ja va，右键 → 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、Ma ven、若依代码）都避免使用中文或空格，防止解析错误。