从前端开发者角度完成若依后端搭建及环境配置

作者：袖梨 2026-05-28

本文详细介绍前端开发者如何在不影响现有环境的情况下，快速搭建若依Java后端服务，涵盖环境配置到联调的全流程关键步骤。

前言

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

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

若依官方推荐

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

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

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

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

  1. 现状：本地已有JDK1.8.0_361、JDK17、JDK19，JDK17用于安卓项目（若没有JDK，需下载安装）

    官方：Oracle JDK8 （可能需要注册，略麻烦）

    非官方：OpenJDK 8（免费无需注册）或者点击这里下载

  2. 配置方式（IDEA内隔离配置，不修改全局环境）：

    1. 打开IDEA → File → Project Structure（Ctrl+Alt+Shift+S）；

    2. 左侧Platform Settings → SDKs → 点击+ → Add SDK → Java，选择本地C:Program FilesJavajdk1.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 FilesJavajdk1.8.0_361binjava.exe即配置生效（验证版本时无需关注Terminal的java -version显示JDK17）。

      项目启动，如图所示，点击RuoYiApplication文件右键：

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

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

  1. 下载：Windows版Redis（推荐5.0.14.1，解压至D:Redis-x64-5.0.14.1，无中文/空格路径）；

  2. 启动：

    1. 管理员身份运行redis-server.exe redis.windows.conf（保持窗口打开）；

    2. 验证：新开CMD执行redis-cli.exe → 输入ping返回PONG即正常；

  3. 若依配置：无需修改application.yml中Redis默认配置（host=localhost、port=6379、无密码）；

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

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

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

  1. 下载地址：Maven 官网（选类似apache-maven-3.6.3-bin.zip的包）；

  2. 解压到非中文路径（比如D:Maven）；

  3. 配置环境变量：新建MAVEN_HOME= 解压路径，Path新增%MAVEN_HOME%bin；

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

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

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

          aliyunmaven
    central
    https://maven.aliyun.com/repository/public

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

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

  1. 没有数据库的可提前进行下载安装，官方网址：MySQL下载安装后，管理员权限进入命令提示符（CMD），启动数据库
net start mysql
mysql -u 用户名 -p  用户名一般是root

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

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

  2. 导入SQL脚本（可视化工具执行，我用的是HeidiSQL，避免命令行路径问题）：

    1. 切换至ruoyi_admin库；

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

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

  3. 若依连接配置（修改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专属驱动

二、启动若依后端

  1. 启动Redis（管理员身份运行redis-server.exe）；

  2. 打开IDEA，加载若依后端代码；

  3. 找到启动类RuoYiApplication.java，右键→Run 'RuoYiApplication'；

  4. 验证启动成功：

    1. IDEA日志无红色报错，最终显示Started RuoYiApplication in XX seconds；

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

通过以上步骤，前端开发者可以顺利完成若依后端的环境配置与联调工作，同时不影响现有项目的开发环境，实现高效协作。

相关文章

精彩推荐