【实战】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_312Docker部署能极大简化后续组件的安装。这里有个小技巧国内用户建议先配置镜像加速sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://your-mirror.mirror.aliyuncs.com] } EOF sudo systemctl restart docker2. 数据库与缓存服务部署2.1 MySQL 5.7容器化安装官方推荐MySQL≥5.7实测5.7.37最稳定。用Docker启动时要注意端口映射docker run --name ruoyi-mysql \ -p 3307:3306 \ -e MYSQL_ROOT_PASSWORDyourpassword \ -d mysql:5.7.37 \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci这里特意映射到3307端口避免与本地已有MySQL冲突。连接测试时建议安装mysql-clientapt-get install mysql-client mysql -h127.0.0.1 -P3307 -uroot -p2.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;常见问题解决方案中文乱码执行SQL前先运行set names utf8mb4;时区错误在连接字符串追加serverTimezoneAsia/ShanghaiSSL警告添加useSSLfalse开发环境可用4. 前后端配置实战4.1 后端关键配置修改application-druid.yml时注意url: jdbc:mysql://localhost:3307/ry-vue?useUnicodetruecharacterEncodingutf8 username: root password: yourpasswordRedis配置在application.yml中redis: host: localhost port: 6379 password: # 如果有密码需要填写4.2 前端运行常见问题在ruoyi-ui目录下执行npm install --registryhttps://registry.npmmirror.com npm run dev踩过的坑Node版本必须≥12建议使用14.x LTS版不要直接使用cnpm可能引发诡异bug内存不足时可设置export NODE_OPTIONS--max_old_space_size40965. 联调与验证5.1 后端启动排错看到这个图案说明启动成功(♥◠‿◠) 若依启动成功 ლ(´ڡლ)常见启动失败原因日志目录权限问题修改logback.xml中的log.path端口冲突检查8080端口是否被占用数据库连接失败确认账号密码和端口5.2 前端访问验证启动成功后访问http://localhost:80默认凭证用户名admin密码admin123第一次登录建议立即修改密码。如果遇到页面空白检查浏览器控制台是否有404错误可能是前端路由配置问题。6. 开发环境优化建议IDEA配置安装Lombok插件开启注解处理热部署后端添加spring-boot-devtools依赖API调试使用knife4j替代原生swagger已集成内存优化给JVM添加参数-Xms512m -Xmx1024m我在团队中推行这套配置时发现新人最容易忽略的是数据库时区设置。有一次全组人花了三小时排查时间戳不对的问题最后发现是MySQL时区没配置为东八区。现在我们都养成了在连接字符串强制指定时区的习惯。