【实战】RuoYi-Vue开发环境一站式部署：从零到一启动前后端分离项目

1. 环境准备：从零搭建基础组件

刚接触RuoYi-Vue时，最头疼的就是环境搭建。记得我第一次部署时，光是处理各种依赖冲突就花了整整两天。现在把踩坑经验总结成这份保姆级教程，帮你半小时搞定全套环境。

JDK安装是第一个门槛。推荐使用JDK 1.8（官方要求≥1.8），实测OpenJDK和Oracle JDK都兼容。以Ubuntu为例：

sudo apt update sudo apt install openjdk-8-jdk

安装后验证版本：

java -version # 应显示类似：openjdk version "1.8.0_312"

Docker部署能极大简化后续组件的安装。这里有个小技巧：国内用户建议先配置镜像加速：

sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://your-mirror.mirror.aliyuncs.com"] } EOF sudo systemctl restart docker

2. 数据库与缓存服务部署

2.1 MySQL 5.7容器化安装

官方推荐MySQL≥5.7，实测5.7.37最稳定。用Docker启动时要注意端口映射：

docker run --name ruoyi-mysql \ -p 3307:3306 \ -e MYSQL_ROOT_PASSWORD=yourpassword \ -d mysql:5.7.37 \ --character-set-server=utf8mb4 \ --collation-server=utf8mb4_unicode_ci

这里特意映射到3307端口，避免与本地已有MySQL冲突。连接测试时建议安装mysql-client：

apt-get install mysql-client mysql -h127.0.0.1 -P3307 -uroot -p

2.2 Redis配置技巧

Redis版本要求≥3.0，推荐使用6.2稳定版。启动容器时建议挂载数据卷持久化：

mkdir -p /docker/redis/data docker run --name ruoyi-redis \ -p 6379:6379 \ -v /docker/redis/data:/data \ -d redis:6.2 \ --appendonly yes

遇到过生产环境Redis突然挂掉的情况，所以强烈建议开启appendonly持久化。

3. 源码获取与初始化

3.1 克隆与项目结构

从Gitee克隆时可能会遇到网络问题，可以尝试多次重试或使用SSH方式：

git clone https://gitee.com/y_project/RuoYi-Vue.git

项目结构说明：

• ruoyi-admin：后端核心模块
• ruoyi-ui：前端Vue项目
• sql/：包含两个关键SQL文件
  • ry_20210908.sql：基础数据表结构
  • quartz.sql：定时任务相关表

3.2 数据库初始化避坑指南

执行SQL前务必先创建数据库并设置编码：

CREATE DATABASE `ry-vue` DEFAULT CHARACTER SET utf8mb4;

常见问题解决方案：

1. 中文乱码：执行SQL前先运行set names utf8mb4;
2. 时区错误：在连接字符串追加&serverTimezone=Asia/Shanghai
3. SSL警告：添加&useSSL=false（开发环境可用）

4. 前后端配置实战

4.1 后端关键配置

修改application-druid.yml时注意：

url: jdbc:mysql://localhost:3307/ry-vue?useUnicode=true&characterEncoding=utf8 username: root password: yourpassword

Redis配置在application.yml中：

redis: host: localhost port: 6379 password: # 如果有密码需要填写

4.2 前端运行常见问题

在ruoyi-ui目录下执行：

npm install --registry=https://registry.npmmirror.com npm run dev

踩过的坑：

• Node版本必须≥12，建议使用14.x LTS版
• 不要直接使用cnpm，可能引发诡异bug
• 内存不足时可设置：export NODE_OPTIONS=--max_old_space_size=4096

5. 联调与验证

5.1 后端启动排错

看到这个图案说明启动成功：

(♥◠‿◠)ﾉﾞ 若依启动成功 ლ(´ڡ`ლ)ﾞ

常见启动失败原因：

1. 日志目录权限问题：修改logback.xml中的log.path
2. 端口冲突：检查8080端口是否被占用
3. 数据库连接失败：确认账号密码和端口

5.2 前端访问验证

启动成功后访问http://localhost:80，默认凭证：

• 用户名：admin
• 密码：admin123

第一次登录建议立即修改密码。如果遇到页面空白，检查浏览器控制台是否有404错误，可能是前端路由配置问题。

6. 开发环境优化建议

1. IDEA配置：安装Lombok插件，开启注解处理
2. 热部署：后端添加spring-boot-devtools依赖
3. API调试：使用knife4j替代原生swagger（已集成）
4. 内存优化：给JVM添加参数-Xms512m -Xmx1024m

我在团队中推行这套配置时，发现新人最容易忽略的是数据库时区设置。有一次全组人花了三小时排查时间戳不对的问题，最后发现是MySQL时区没配置为东八区。现在我们都养成了在连接字符串强制指定时区的习惯。