RuoYi-Vue-master：Spring Boot 4.x (JDK 17+) （环境搭建）

📦 RuoYi-Vue master 分支全环境稳定版本 + 官方下载地址

下面是你全新项目开发的全链路稳定版本组合 ，每个组件都附了官方直达下载地址 ，直接点就能下，零踩坑：
提示：环境配置教程在最下面

一、后端核心环境（必装）

1. JDK 17 LTS（Spring Boot 4.x 强制要求）

发行版	推荐版本	官方下载地址	选型说明
Eclipse Temurin (Adoptium) OpenJDK 17（企业首选，免费无授权）	17.0.10+ LTS	https://adoptium.net/zh-CN/temurin/releases/?version=17\[1\]	开源免费、全平台支持、社区最稳定，生产环境首选
Oracle JDK 17 LTS	17.0.10+ LTS	https://www.oracle.com/java/technologies/downloads/#java17\[2\]	官方原版，需注册Oracle账号，注意商业授权
Amazon Corretto 17	17.0.10+ LTS	https://docs.aws.amazon.com/corretto/latest/corretto-17-ug/downloads-list.html\[3\]	亚马逊开源发行版，免费稳定，适合云环境

✅ 安装提示：Windows选.msi自动配置环境变量，Linux选.tar.gz手动解压，Mac选对应芯片架构。

2. Apache Maven（项目构建工具）

推荐版本	官方下载地址	选型说明
3.8.8（长期稳定版）	https://maven.apache.org/download.cgi\[4\] （页面选3.8.8）	社区沉淀最久，无兼容性问题，适合老项目/保守选型
3.9.6（最新稳定版）	https://maven.apache.org/download.cgi\[5\] （页面选3.9.6）	性能优化更好，适合新项目，完全兼容Spring Boot 4.x

✅ 安装提示：Windows下载apache-maven-xxx-bin.zip，Linux/Mac下载-bin.tar.gz，不要下source源码包。

3. MySQL（数据库）

推荐版本	官方下载地址	选型说明
MySQL 8.0.36+（推荐，主流稳定版）	https://dev.mysql.com/downloads/mysql/\[6\] （选8.0.x） / https://downloads.mysql.com/archives/community/\[7\]	支持最新特性、性能更优，新项目首选
MySQL 5.7.44（兼容老系统）	https://downloads.mysql.com/archives/community/\[8\] （选5.7.44）	仅用于需要兼容老系统的场景，8.0是未来趋势

✅ 安装提示：Windows用MySQL Installer一键安装配置，Linux用tar.gz源码包或yum/apt安装。

4. Redis（缓存中间件）

推荐版本	官方下载地址	选型说明
Redis 6.2.14（LTS长期支持版）	https://download.redis.io/releases/redis-6.2.14.tar.gz\[9\] / https://redis.io/download/\[10\]	稳定性拉满，生产环境首选，无新特性风险
Redis 7.2.4（最新稳定版）	https://download.redis.io/releases/redis-7.2.4.tar.gz\[11\] / https://redis.io/download/\[12\]	性能更强，适合追求新特性的场景

✅ 安装提示：Linux直接用wget下载源码编译，Windows用微软维护的发行版（https://github.com/microsoftarchive/redis/releases）。\[13\]

二、前端核心环境（必装）

1. Node.js（前端运行环境）

推荐版本	官方下载地址	选型说明
Node.js 18.19.1 LTS（Hydrogen，推荐）	https://nodejs.org/en/download/archive/v18.19.1/\[14\] / https://nodejs.cn/download/\[15\]	Vue 2/3生态最兼容，无高版本依赖冲突，开发/生产都稳
Node.js 20.12.2 LTS（Iron）	https://nodejs.org/en/blog/release/v20.12.2/\[16\] / https://nodejs.org/\[17\]	最新LTS，性能更好，适合新项目

✅ 安装提示：Windows选.msi自动配置环境变量，自带npm 9.6.7，无需额外安装npm。

2. 包管理器（pnpm 可选，npm 随Node自带）

工具	推荐版本	安装方式	说明
npm	9.6.7（随Node 18自带）	无需额外下载	官方原生，若依项目默认支持，零配置
pnpm 8.15.5（推荐提速）	8.15.5	安装命令：`npm install -g pnpm@8.15.5`	比npm快3-5倍，节省磁盘空间，适合前端开发

✅ 安装提示：pnpm无需单独下载安装包，Node安装后直接用npm全局安装即可。

三、生产环境辅助工具（推荐）

1. Nginx（反向代理/前端部署）

推荐版本	官方下载地址	选型说明
Nginx 1.26.1（稳定版）	https://nginx.org/download/nginx-1.26.1.tar.gz\[18\] / https://nginx.org/en/download.html\[19\]	最新稳定版，性能和稳定性平衡，生产首选
Nginx 1.25.5（主线版）	https://nginx.org/download/nginx-1.25.5.tar.gz\[20\]	包含新特性，适合测试环境，不推荐生产

✅ 安装提示：Windows下载nginx-xxx.zip直接解压运行，Linux用源码编译或yum/apt安装。

四、开发工具（可选，推荐）

工具	推荐版本	官方下载地址	用途
IntelliJ IDEA	2024.1+	https://www.jetbrains.com/idea/download/\[21\]	后端Java/Spring Boot开发，对JDK 17、Spring Boot 4.x支持最佳
VS Code	1.88+	https://code.visualstudio.com/download\[22\]	前端Vue开发，轻量高效
Docker（容器化部署）	25.0.3+	https://www.docker.com/get-started/\[23\]	一键部署项目环境，避免环境差异

🚀 快速安装&验证命令（一键检查环境）

后端环境验证

# 验证JDK

复制代码

java -version# 验证Mavenmvn -v# 验证MySQLmysql --version# 验证Redisredis-server --version

前端环境验证

复制代码

# 验证Node.js/npmnode -vnpm -v# 验证pnpm（如果安装）pnpm -v

⚠️ 避坑红线（绝对不要踩）

1.JDK 17是唯一选择：master分支基于Spring Boot 4.x，不支持JDK 8/11 ，强行使用会直接启动失败；2.全链路LTS优先：所有组件优先选「长期支持版（LTS）」，避免非LTS版本（如JDK 18/19、Node 19/21）的兼容性问题；3.环境一致性：开发、测试、生产环境必须使用完全相同的版本 ，杜绝「本地能跑、线上报错」的版本差异问题；4.不要用cnpm：前端依赖安装严禁用cnpm，会出现依赖缺失、版本错乱，用npm/pnpm原生安装。

需要我给你一份从0到1的环境安装+项目启动保姆级步骤吗？包含每个工具的环境变量配置、Maven阿里云镜像配置、MySQL初始化脚本，直接照着做就能跑通项目。

Maven环境适配：

3.9.6 官方下载入口 & 直链

1. 官方历史版本归档页（推荐入口）

访问 Maven 官方历史版本库：https://archive.apache.org/dist/maven/maven-3/找到 3.9.6 文件夹 → 进入 binaries 目录，即可下载对应包：

Windows 用：apache-maven-3.9.6-bin.zip
Linux/Mac 用：apache-maven-3.9.6-bin.tar.gz

2. 直接下载直链（复制到浏览器即可下载）

Windows 二进制 zip 包 ：https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.zip
Linux/Mac 二进制 tar.gz 包 ：https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz

一、先选对下载包（别下错！）

你当前页面只有源码包（src开头） ，不能用！必须下载二进制包（bin开头），步骤如下：

1. 回到正确目录

点击页面最上方的 Parent Directory （父目录），回到 3.9.6 根目录，再进入 binaries 文件夹，就能看到正确的二进制包：

•✅ Windows系统 ：下载 apache-maven-3.9.6-bin.zip•✅ Linux/Mac系统 ：下载 apache-maven-3.9.6-bin.tar.gz

🔴 绝对不要下载 src 开头的包（源码包需要自己编译，普通开发用不上）

二、Maven 核心配置（settings.xml 模板，直接用）

解压 Maven 后，找到 conf/settings.xml 文件，用下面的完整配置替换，一键解决国内下载慢、依赖拉不到的问题，完全适配 RuoYi-Vue 项目：

bash 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 http://maven.apache.org/xsd/settings-1.2.0.xsd">

  <!-- 本地仓库路径（改成你自己的目录，建议非系统盘） -->
  <localRepository>D:\maven\repository</localRepository>

  <!-- 全局镜像（阿里云，国内首选，100%覆盖中央仓库） -->
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    <mirror>
      <id>aliyunmaven-spring</id>
      <mirrorOf>spring</mirrorOf>
      <name>阿里云Spring仓库</name>
      <url>https://maven.aliyun.com/repository/spring</url>
    </mirror>
  </mirrors>

  <!-- JDK 17 编译配置（适配RuoYi-Vue master/springboot3分支） -->
  <profiles>
    <profile>
      <id>jdk-17</id>
      <activation>
        <activeByDefault>true</activeByDefault>
        <jdk>17</jdk>
      </activation>
      <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      </properties>
    </profile>

    <!-- 若用springboot2分支/JDK8，用这个profile替换上面的jdk-17 -->
    <!--
    <profile>
      <id>jdk-8</id>
      <activation>
        <activeByDefault>true</activeByDefault>
        <jdk>1.8</jdk>
      </activation>
      <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      </properties>
    </profile>
    -->
  </profiles>

  <!-- 全局激活jdk-17 profile -->
  <activeProfiles>
    <activeProfile>jdk-17</activeProfile>
  </activeProfiles>

</settings>

三、关键配置说明（按需修改）

1.本地仓库路径：

•把 <localRepository>D:\maven\repository</localRepository> 改成你自己的目录，比如 D:\dev\maven-repo，不要放在C盘，避免系统盘爆满。

2.JDK版本适配：

•用 master/springboot3 分支（JDK17） ：保留 jdk-17 配置，注释 jdk-8•用 springboot2 分支（JDK8） ：注释 jdk-17，启用 jdk-8 配置

3.镜像说明：

•阿里云公共仓库完全替代 Maven 中央仓库，国内下载速度提升10倍以上，RuoYi-Vue 所有依赖都能正常拉取。

四、环境变量配置（Windows 示例）

1.新建系统变量 MAVEN_HOME，值为 Maven 解压目录（比如 D:\dev\apache-maven-3.9.6）2.编辑系统变量 Path，新增 %MAVEN_HOME%\bin3.验证：打开CMD，执行 mvn -v，能看到版本号即配置成功

五、避坑提醒

•下载包必须是 bin 开头，src 开头的源码包无法直接使用•配置文件必须放在 conf/settings.xml，不要放错位置•本地仓库目录不要有中文、空格，避免路径错误•配置完成后，第一次执行 mvn clean install 会自动下载依赖到本地仓库，耐心等待即可

需要我给你一份从解压到环境变量配置、再到项目启动的完整步骤 吗？直接照着做就能跑通 RuoYi-Vue。

MySQL 8.0.30 winx64.zip 安装教程

我给你最简单、最稳妥、一步不踩坑 的 MySQL 8.0.30（winx64.zip）解压版安装教程，全程照着做就能用！

MySQL 8.0.30 winx64.zip 安装教程（纯手动版）

一、准备工作

把你下载的 mysql-8.0.30-winx64.zip 解压推荐路径：D:\mysql-8.0.30-winx64 ✅ 路径不要有中文、空格

在解压目录里新建两个东西

•新建文件夹：data （空文件夹）•新建文件：my.ini（配置文件）

二、编辑 my.ini 配置文件

把下面内容直接复制进去 ，只需要改路径：

sql 复制代码

[mysqld]
# 设置3306端口
port=3306
# 设置mysql的安装目录（改成你自己的解压路径）
basedir=D:\\mysql-8.0.30-winx64
# 设置mysql数据库的数据的存放目录
datadir=D:\\mysql-8.0.30-winx64\\data
# 允许最大连接数
max_connections=200
# 允许连接失败的次数
max_connect_errors=10
# 服务端使用的字符集默认为UTF8MB4
character-set-server=utf8mb4
# 创建新表时将使用的默认存储引擎
default-storage-engine=INNODB
# 默认使用"mysql_native_password"插件认证
default_authentication_plugin=mysql_native_password

[mysql]
# 设置mysql客户端默认字符集
default-character-set=utf8mb4

[client]
# 设置mysql客户端连接服务端时默认使用的端口
port=3306
default-character-set=utf8mb4

注意：

•路径必须用 \\ 双反斜杠•basedir 和 datadir 必须是你真实的路径

三、初始化 MySQL（关键步骤）

以管理员身份打开 cmd

进入 MySQL 的 bin 目录

复制代码

cd D:\mysql-8.0.30-winx64\bin

3.执行初始化命令（会生成临时密码）

复制代码

mysqld --initialize --console

执行完后，你会看到一行：

复制代码

A temporary password is generated for root@localhost: ********

✅ 把这个密码记下来！后面必须用！

四、安装 MySQL 服务

复制代码

mysqld --install mysql8

出现：Service successfully installed. 就成功了

五、启动服务

复制代码

net start mysql8

六、登录并修改密码（非常重要）

复制代码

mysql -uroot -p

粘贴刚才的临时密码登录

登录成功后执行：

复制代码

ALTER USER 'root'@'localhost' IDENTIFIED BY '123456';

密码改成你自己的，比如 123456

然后刷新权限：

复制代码

FLUSH PRIVILEGES;

七、配置环境变量（让任何地方都能用 mysql 命令）

1.右键此电脑 → 属性 → 高级系统设置 → 环境变量2.系统变量 → 新建

•变量名：MYSQL_HOME

•变量值：D:\mysql-8.0.30-winx64

3.找到 Path → 编辑 → 新建

复制代码

%MYSQL_HOME%\bin

安装完成！测试一下

关闭 cmd，重新打开普通 cmd

复制代码

mysql -uroot -p123456

能直接进入 MySQL 就说明完全装好了！

总结

1.解压 → 新建 data + my.ini2.初始化 → 得到临时密码3.安装服务 → 启动服务4.登录 → 修改密码5.配置环境变量

你跟着我这一套做，100%能装好。需要我一步步带你截图式讲解吗？或者你现在做到哪一步了，我直接帮你看！

RuoYi-Vue-master：Spring Boot 4.x (JDK 17+) （环境搭建）

📦 RuoYi-Vue master 分支 全环境稳定版本 + 官方下载地址

一、后端核心环境（必装）

1. JDK 17 LTS（Spring Boot 4.x 强制要求）

2. Apache Maven（项目构建工具）

3. MySQL（数据库）

4. Redis（缓存中间件）

二、前端核心环境（必装）

1. Node.js（前端运行环境）

2. 包管理器（pnpm 可选，npm 随Node自带）

三、生产环境辅助工具（推荐）

1. Nginx（反向代理/前端部署）

四、开发工具（可选，推荐）

🚀 快速安装&验证命令（一键检查环境）

后端环境验证

# 验证JDK

前端环境验证

⚠️ 避坑红线（绝对不要踩）

Maven环境适配：

3.9.6 官方下载入口 & 直链

1. 官方历史版本归档页（推荐入口）

2. 直接下载直链（复制到浏览器即可下载）

一、先选对下载包（别下错！）

1. 回到正确目录

二、Maven 核心配置（settings.xml 模板，直接用）

三、关键配置说明（按需修改）

四、环境变量配置（Windows 示例）

五、避坑提醒

MySQL 8.0.30 winx64.zip 安装教程

MySQL 8.0.30 winx64.zip 安装教程（纯手动版）

一、准备工作

二、编辑 my.ini 配置文件

三、初始化 MySQL（关键步骤）

四、安装 MySQL 服务

五、启动服务

六、登录并修改密码（非常重要）

七、配置环境变量（让任何地方都能用 mysql 命令）

安装完成！测试一下

总结

📦 RuoYi-Vue master 分支全环境稳定版本 + 官方下载地址