从零构建RuoYi-Vue 3.7.0生产环境IDE高效部署实战手册在前后端分离架构成为主流的今天RuoYi-Vue作为基于Spring BootVue的快速开发框架凭借其丰富的功能模块和清晰的代码结构已成为企业级应用开发的热门选择。但许多开发者在首次部署时常因环境配置差异、工具链不统一等问题陷入明明按照文档操作却无法正常运行的困境。本文将基于工具链锁定和版本固化的思路通过IntelliJ IDEA和Visual Studio Code这两款主流IDE配合JDK 1.8MySQL 5.7的经典环境组合带你完成一次高可复现的War包部署全流程。1. 环境准备与工具配置1.1 开发环境标准化清单部署RuoYi-Vue 3.7.0需要确保以下环境完全匹配版本偏差可能导致不可预期错误组件指定版本验证命令JDK1.8.xjava -versionMySQL5.7.xmysql --versionRedis4.0.xredis-server -vTomcat8.5.xcatalina.sh versionNode.js14.xnode -vnpm6.xnpm -v提示建议使用Docker创建隔离环境避免与现有开发环境冲突。例如MySQL 5.7可通过docker run --name mysql5.7 -e MYSQL_ROOT_PASSWORD123456 -p 3306:3306 -d mysql:5.7快速部署1.2 IDE关键插件安装在IntelliJ IDEA中需确保已安装Lombok Plugin避免编译时注解报错Maven Helper依赖冲突分析Database Tools数据库可视化操作VSCode前端开发推荐插件VolarVue 3语言支持ESLint代码规范检查npm Intellisense自动补全npm模块# 验证后端环境IDEA终端执行 mvn -v Java HotSpot(TM) 64-Bit Server VM (build 25.381-b09, mixed mode) Apache Maven 3.8.6 # 验证前端环境VSCode终端执行 node -v v14.21.32. 后端工程War包化改造2.1 POM文件关键修改在IntelliJ IDEA中打开项目后需要对ruoyi-admin/pom.xml进行三处核心修改修改打包方式为warpackagingwar/packaging排除内嵌Tomcat避免与外部Tomcat冲突dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-tomcat/artifactId scopeprovided/scope /dependency添加构建插件确保静态资源正确打包plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-war-plugin/artifactId version3.3.2/version configuration warSourceDirectorysrc/main/webapp/warSourceDirectory /configuration /plugin2.2 配置文件精准调校application.yml需要特别注意以下参数server: servlet: context-path: / tomcat: basedir: /tmp/tomcat-temp # 避免Linux系统权限问题 spring: redis: host: 192.168.1.100 # 确保与Redis服务器IP一致 port: 6379 password: ruoyi123 # 生产环境建议使用Vault加密数据库连接池配置application-druid.ymlspring: datasource: druid: url: jdbc:mysql://localhost:3306/ry-vue?useUnicodetruecharacterEncodingutf8zeroDateTimeBehaviorconvertToNulluseSSLfalse username: root password: 123456 initial-size: 5 # 根据服务器配置调整 max-active: 20 # 生产环境建议503. 前端工程构建与优化3.1 依赖安装与构建加速在VSCode终端中执行以下命令前建议先配置淘宝镜像npm config set registry https://registry.npmmirror.com然后安装依赖使用--legacy-peer-deps避免版本冲突npm install --legacy-peer-deps生产环境构建命令需要添加--modern模式优化性能npm run build:prod -- --modern3.2 Nginx高级配置模板针对前后端分离架构推荐使用以下Nginx配置/etc/nginx/conf.d/ruoyi.confserver { listen 80; server_name your-domain.com; # 前端静态资源 location / { root /home/ruoyi/projects/ruoyi-ui/dist; try_files $uri $uri/ /index.html; expires 30d; add_header Cache-Control public, no-transform; } # 后端API代理 location /prod-api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_connect_timeout 60s; proxy_read_timeout 600s; } # 禁止访问敏感文件 location ~* ^/(WEB-INF|META-INF)/ { deny all; } }4. 部署实战与排错指南4.1 Tomcat服务器调优修改$TOMCAT_HOME/conf/server.xml中的Connector配置Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 maxThreads200 minSpareThreads20 acceptCount100 compressionon compressionMinSize2048 compressableMimeTypetext/html,text/xml,text/css,application/javascript/Context配置需特别注意解决404问题的关键Context path docBase/opt/tomcat/webapps/ruoyi-admin reloadablefalse Resources cachingAllowedtrue cacheMaxSize100000 / /Context4.2 常见问题速查表现象可能原因解决方案验证码不显示Redis连接失败检查spring.redis配置和防火墙规则接口404context-path不匹配统一前后端的prod-api路径前缀静态资源加载失败Nginx权限问题执行chown -R nginx:nginx /home/ruoyi数据库连接池耗尽连接泄漏在Druid中开启removeAbandoned参数4.3 性能监控建议部署完成后推荐在IDEA中配置Arthas远程诊断# 服务器上安装Arthas wget https://arthas.aliyun.com/arthas-boot.jar java -jar arthas-boot.jar ruoyi-admin.jar常用诊断命令dashboard实时系统监控trace com.ruoyi.*Controller *追踪方法调用链路profiler start生成火焰图分析性能瓶颈在项目成功运行后建议立即修改默认账号密码并开启Spring Security的CSRF防护。对于生产环境还应该配置HTTPS证书和定期备份策略。