1. 环境准备搭建稳定的部署基础部署RuoYi前后端分离项目前环境准备是重中之重。我遇到过不少开发者因为基础环境配置不当导致后续步骤频繁报错。这里分享我经过多次实战验证的标准化环境搭建方案。首先明确软件版本兼容性非常关键。根据官方文档和实际测试推荐以下组合JDK 1.8注意不要使用OpenJDK 11部分类库存在兼容性问题MySQL 5.7比8.0版本更稳定字符集建议统一为utf8mb4Redis 4.0若依的会话管理依赖Redis低版本可能出问题Nginx 1.18需要支持try_files指令处理前端路由Tomcat 8.5注意不要用Tomcat 9部分Servlet API有变动安装完基础软件后需要特别注意三个配置细节MySQL权限设置创建数据库时建议执行set global validate_password_policy0;降低密码复杂度要求Redis内存配置在redis.conf中修改maxmemory 256mb避免内存溢出防火墙设置开放端口时不仅要放行80/8080还需要开放3306(MySQL)和6379(Redis)端口验证环境是否就绪的快速检查命令# 检查Java版本 java -version # 检查MySQL服务状态 systemctl status mysqld # 测试Redis连接 redis-cli ping2. 后端部署从代码修改到服务启动2.1 关键配置修改实战下载代码后需要修改四个核心配置文件。这里分享我总结的最佳实践pom.xml修改要点!-- 修改打包方式为war -- packagingwar/packaging !-- 添加Tomcat依赖作用域 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-tomcat/artifactId scopeprovided/scope /dependencyapplication.yml的避坑配置# 关键修改点 server: servlet: context-path: / port: 8080 tomcat: uri-encoding: UTF-8 # Redis配置要特别注意连接超时设置 redis: host: 127.0.0.1 port: 6379 timeout: 3000ms # 默认值太短会导致连接超时数据库配置的隐藏坑 在application-druid.yml中建议添加以下参数# 连接池关键配置 initialSize: 5 minIdle: 5 maxActive: 20 maxWait: 60000 testWhileIdle: true # 必须开启空闲检测2.2 打包与部署技巧打包时常见两个问题依赖下载失败建议先执行mvn clean install -DskipTestsWar包过大通过exclusions排除不必要的依赖部署到Tomcat时要注意# 先停止旧服务 ./shutdown.sh # 删除旧war包和解压目录 rm -rf ../webapps/ruoyi-admin* # 上传新war包后启动 ./startup.sh # 实时查看日志 tail -f ../logs/catalina.out验证后端是否启动成功的终极方法# 检查端口占用 netstat -tlnp | grep 8080 # 测试接口 curl http://localhost:8080/captchaImage3. 前端部署Nginx配置的艺术3.1 前端打包的隐藏选项使用npm构建时推荐添加参数提高打包成功率# 使用淘宝源加速 npm install --registryhttps://registry.npmmirror.com # 生产环境构建 npm run build:prod -- --modern构建完成后必须在dist目录下创建WEB-INF/web.xml?xml version1.0 encodingUTF-8? web-app error-page error-code404/error-code location/index.html/location /error-page /web-app3.2 Nginx高可用配置方案这是我优化过的nginx.conf配置模板server { listen 80; server_name your-domain.com; # 静态资源配置 location / { root /home/ruoyi/projects/ruoyi-ui; try_files $uri $uri/ /index.html; # 开启gzip压缩 gzip on; gzip_types text/plain application/javascript application/x-javascript text/css; } # 接口代理配置 location /prod-api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_connect_timeout 60s; # 适当延长超时 proxy_read_timeout 300s; # 解决413请求实体过大问题 client_max_body_size 50m; } # 错误页面处理 error_page 500 502 503 504 /50x.html; }启动Nginx后验证配置的正确方法# 测试配置语法 nginx -t # 平滑重启 nginx -s reload # 查看进程 ps aux | grep nginx4. 避坑指南血泪经验总结4.1 验证码不显示的终极解决方案遇到验证码问题时按这个顺序排查检查Redis连接是否正常验证后端/captchaImage接口是否返回图片流查看浏览器控制台是否有跨域错误确保Nginx配置中/prod-api/路径代理正确常见错误案例Caused by: io.lettuce.core.RedisConnectionException: Unable to connect to 127.0.0.1:6379解决方案是在application.yml中增加lettuce: pool: max-active: 8 max-wait: -1ms4.2 404错误的深度处理当出现404错误时重点检查三个地方Tomcat的server.xml配置Context docBase/usr/local/tomcat/webapps/ruoyi-admin path/ reloadabletrue/Spring Boot的上下文路径设置server.servlet.context-path/前端axios的baseURL配置// 确保与Nginx配置一致 axios.defaults.baseURL /prod-api4.3 性能优化建议经过压力测试后给出的优化方案Tomcat调优# 在catalina.sh中添加 JAVA_OPTS-server -Xms1024m -Xmx2048m -XX:MaxMetaspaceSize512mMySQL优化-- 为ruoyi-vue的表添加关键索引 ALTER TABLE sys_logininfor ADD INDEX idx_login_time (login_time); ALTER TABLE sys_oper_log ADD INDEX idx_oper_time (oper_time);Redis缓存配置# 在application.yml中增加 spring: cache: type: redis redis: time-to-live: 3600000 # 1小时过期5. 高级部署方案5.1 多环境配置管理推荐使用profile机制管理不同环境# application-dev.yml spring: profiles: active: dev redis: host: dev-redis.example.com # application-prod.yml spring: profiles: active: prod redis: host: 127.0.0.1打包时指定环境mvn package -Pprod5.2 容器化部署方案Docker部署的完整流程构建后端镜像FROM openjdk:8-jdk COPY target/ruoyi-admin.war /app.war ENTRYPOINT [java,-jar,/app.war]前端Nginx配置FROM nginx:1.18 COPY dist/ /usr/share/nginx/html COPY nginx.conf /etc/nginx/conf.d/default.conf启动命令docker-compose up -d5.3 监控与维护推荐的监控方案组合Spring Boot Actuatordependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependencyPrometheus监控配置management: endpoints: web: exposure: include: * metrics: tags: application: ruoyi-admin日志收集方案!-- logback-spring.xml配置 -- appender nameELK classnet.logstash.logback.appender.LogstashTcpSocketAppender destination127.0.0.1:5000/destination /appender
RuoYi若依前后端分离版war包部署实战：从环境准备到避坑指南
发布时间：2026/6/29 9:53:30
1. 环境准备搭建稳定的部署基础部署RuoYi前后端分离项目前环境准备是重中之重。我遇到过不少开发者因为基础环境配置不当导致后续步骤频繁报错。这里分享我经过多次实战验证的标准化环境搭建方案。首先明确软件版本兼容性非常关键。根据官方文档和实际测试推荐以下组合JDK 1.8注意不要使用OpenJDK 11部分类库存在兼容性问题MySQL 5.7比8.0版本更稳定字符集建议统一为utf8mb4Redis 4.0若依的会话管理依赖Redis低版本可能出问题Nginx 1.18需要支持try_files指令处理前端路由Tomcat 8.5注意不要用Tomcat 9部分Servlet API有变动安装完基础软件后需要特别注意三个配置细节MySQL权限设置创建数据库时建议执行set global validate_password_policy0;降低密码复杂度要求Redis内存配置在redis.conf中修改maxmemory 256mb避免内存溢出防火墙设置开放端口时不仅要放行80/8080还需要开放3306(MySQL)和6379(Redis)端口验证环境是否就绪的快速检查命令# 检查Java版本 java -version # 检查MySQL服务状态 systemctl status mysqld # 测试Redis连接 redis-cli ping2. 后端部署从代码修改到服务启动2.1 关键配置修改实战下载代码后需要修改四个核心配置文件。这里分享我总结的最佳实践pom.xml修改要点!-- 修改打包方式为war -- packagingwar/packaging !-- 添加Tomcat依赖作用域 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-tomcat/artifactId scopeprovided/scope /dependencyapplication.yml的避坑配置# 关键修改点 server: servlet: context-path: / port: 8080 tomcat: uri-encoding: UTF-8 # Redis配置要特别注意连接超时设置 redis: host: 127.0.0.1 port: 6379 timeout: 3000ms # 默认值太短会导致连接超时数据库配置的隐藏坑 在application-druid.yml中建议添加以下参数# 连接池关键配置 initialSize: 5 minIdle: 5 maxActive: 20 maxWait: 60000 testWhileIdle: true # 必须开启空闲检测2.2 打包与部署技巧打包时常见两个问题依赖下载失败建议先执行mvn clean install -DskipTestsWar包过大通过exclusions排除不必要的依赖部署到Tomcat时要注意# 先停止旧服务 ./shutdown.sh # 删除旧war包和解压目录 rm -rf ../webapps/ruoyi-admin* # 上传新war包后启动 ./startup.sh # 实时查看日志 tail -f ../logs/catalina.out验证后端是否启动成功的终极方法# 检查端口占用 netstat -tlnp | grep 8080 # 测试接口 curl http://localhost:8080/captchaImage3. 前端部署Nginx配置的艺术3.1 前端打包的隐藏选项使用npm构建时推荐添加参数提高打包成功率# 使用淘宝源加速 npm install --registryhttps://registry.npmmirror.com # 生产环境构建 npm run build:prod -- --modern构建完成后必须在dist目录下创建WEB-INF/web.xml?xml version1.0 encodingUTF-8? web-app error-page error-code404/error-code location/index.html/location /error-page /web-app3.2 Nginx高可用配置方案这是我优化过的nginx.conf配置模板server { listen 80; server_name your-domain.com; # 静态资源配置 location / { root /home/ruoyi/projects/ruoyi-ui; try_files $uri $uri/ /index.html; # 开启gzip压缩 gzip on; gzip_types text/plain application/javascript application/x-javascript text/css; } # 接口代理配置 location /prod-api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_connect_timeout 60s; # 适当延长超时 proxy_read_timeout 300s; # 解决413请求实体过大问题 client_max_body_size 50m; } # 错误页面处理 error_page 500 502 503 504 /50x.html; }启动Nginx后验证配置的正确方法# 测试配置语法 nginx -t # 平滑重启 nginx -s reload # 查看进程 ps aux | grep nginx4. 避坑指南血泪经验总结4.1 验证码不显示的终极解决方案遇到验证码问题时按这个顺序排查检查Redis连接是否正常验证后端/captchaImage接口是否返回图片流查看浏览器控制台是否有跨域错误确保Nginx配置中/prod-api/路径代理正确常见错误案例Caused by: io.lettuce.core.RedisConnectionException: Unable to connect to 127.0.0.1:6379解决方案是在application.yml中增加lettuce: pool: max-active: 8 max-wait: -1ms4.2 404错误的深度处理当出现404错误时重点检查三个地方Tomcat的server.xml配置Context docBase/usr/local/tomcat/webapps/ruoyi-admin path/ reloadabletrue/Spring Boot的上下文路径设置server.servlet.context-path/前端axios的baseURL配置// 确保与Nginx配置一致 axios.defaults.baseURL /prod-api4.3 性能优化建议经过压力测试后给出的优化方案Tomcat调优# 在catalina.sh中添加 JAVA_OPTS-server -Xms1024m -Xmx2048m -XX:MaxMetaspaceSize512mMySQL优化-- 为ruoyi-vue的表添加关键索引 ALTER TABLE sys_logininfor ADD INDEX idx_login_time (login_time); ALTER TABLE sys_oper_log ADD INDEX idx_oper_time (oper_time);Redis缓存配置# 在application.yml中增加 spring: cache: type: redis redis: time-to-live: 3600000 # 1小时过期5. 高级部署方案5.1 多环境配置管理推荐使用profile机制管理不同环境# application-dev.yml spring: profiles: active: dev redis: host: dev-redis.example.com # application-prod.yml spring: profiles: active: prod redis: host: 127.0.0.1打包时指定环境mvn package -Pprod5.2 容器化部署方案Docker部署的完整流程构建后端镜像FROM openjdk:8-jdk COPY target/ruoyi-admin.war /app.war ENTRYPOINT [java,-jar,/app.war]前端Nginx配置FROM nginx:1.18 COPY dist/ /usr/share/nginx/html COPY nginx.conf /etc/nginx/conf.d/default.conf启动命令docker-compose up -d5.3 监控与维护推荐的监控方案组合Spring Boot Actuatordependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependencyPrometheus监控配置management: endpoints: web: exposure: include: * metrics: tags: application: ruoyi-admin日志收集方案!-- logback-spring.xml配置 -- appender nameELK classnet.logstash.logback.appender.LogstashTcpSocketAppender destination127.0.0.1:5000/destination /appender
相关文章
如何专业优化Windows系统：高效清理工具实战指南
如何专业优化Windows系统：高效清理工具实战指南 【免费下载链接】WindowsCleaner Windows Cleaner——专治C盘爆红及各种不服！ 项目地址: https://gitcode.com/gh_mirrors/wi/WindowsCleaner 面对C盘空间不足的红色警告，你是否感到束手…
Appium并行测试与CI/CD集成实战：构建高效移动自动化测试体系
1. 项目概述：为什么我们需要“高级”的Appium实战？如果你已经用Appium写过一些简单的自动化测试脚本，比如登录、点击几个按钮，那你可能已经感受到了它的便利。但当你面对几十台不同型号的手机、需要每天跑几百个测试用例、并且希望…
第15天：Copy-on-Write 机制：写时复制的核心原理与性能优化
从"共享笔记"到"按需复制"：揭秘Linux内存管理的高效魔法想象一下，你和同事共同编辑一份重要的项目文档。为了节省时间和空间，你们决定先共享同一份文档，只有当其中一人需要修改内容时，才复制一份副…
深入解析OWASP TOP 10：Web应用安全核心漏洞原理与实战防御
1. 项目概述：为什么我们需要深入理解OWASP TOP 10？如果你是一名Web开发者、安全工程师，或者正在负责一个线上产品的技术运维，那么“安全”这个词，大概率已经从“锦上添花”变成了“悬在头顶的达摩克利斯之剑”。每天&a…
5分钟快速上手PT站一键转载脚本：完全免费的高效种子分享工具
5分钟快速上手PT站一键转载脚本：完全免费的高效种子分享工具 【免费下载链接】auto_feed_js PT站一键转载脚本 项目地址: https://gitcode.com/gh_mirrors/au/auto_feed_js auto_feed_js是一款专为PT（Private Tracker）用户设计的强大一…
2026常州黄金回收白银回收铂金回收旧料回收怎么选？五家高实价铂金白银线下门店测评清单 + 联系方式
常州街头巷尾的黄金、铂金、白银回收门店可谓鳞次栉比，其中既有诚信经营的百年老号，也不乏浑水摸鱼的短期摊位，鱼龙混杂的局面让市民变现时难免举棋不定。为了帮大家甄别靠谱渠道，小编实地走访、层层筛选，整理出一份正…
点云实战指南：PCL可视化交互与多视图应用
1. PCL可视化基础入门 第一次接触PCL可视化时，我被它强大的三维渲染能力震撼到了。记得当时加载了一个兔子点云模型，旋转缩放时那种流畅的交互体验，让我瞬间理解了为什么PCL会成为点云处理的事实标准。PCLVisualizer作为核心可视化类…
技术视角下的《二十年后》：从代码注释到架构设计的承诺与背叛
1. 代码注释里的二十年之约 二十年前刚入行时，我和大学室友阿杰在毕业前夜给开源项目写了个TODO注释："等我们成为架构师后，一定要重构这个模块"。当时我们像小说里点着雪茄的鲍勃和吉米，坚信技术理想能战胜时间。但现实…
ai饰品模特新趋势，主流图生成平台全景解析
ai饰品模特技术正在重塑电商图片生产，快速生成多样模特图和场景细节已成为主流平台的竞争方向。作为深度参与者，我将综合评测业内主流平台，帮助大家高效选出适合自身的解决方案。 作图鸟 作图鸟地址：https://www.zuotuniao.com/…
Java开发者转型安全开发：从代码审计到自动化工具实践
1. 转型背景与核心驱动力最近几年，身边不少做Java后端开发的朋友，都开始或多或少地关注起安全开发这个方向。我自己也是从写了七八年Java业务代码，一步步转向了安全领域，现在主要做代码审计和自动化安全工具开发。这个转变不是一时…
【TEE从入门到精通及实战】75 TEE内Wasm沙箱的内存安全：从“段错误”到“编译时保证”
75 TEE内Wasm沙箱的内存安全：从“段错误”到“编译时保证” 开篇故事 去年夏天，我正帮一家金融科技公司优化他们的TEE内Wasm沙箱。他们的核心业务是在Intel SGX enclave里运行用户提交的Wasm合约，用于实时交易验证。 一天下午，运维突然报警：生产环境的enclave进程频繁崩…
YAML函数动态解析：打造智能接口自动化测试用例
1. 项目概述：为什么YAML测试用例需要函数动态解析？在接口自动化测试的实践中，我们常常会面临一个核心矛盾：测试用例的可维护性与灵活性。早期的测试脚本，无论是用Python的unittest还是pytest，往往将测试数据…
AI Coding 六个月真实ROI账本：产品经理的血泪教训，研发的冷静忠告
6个月前的2025年12月，Boris Cherny 公开宣布自己卸载了 IDE。一时间，Vibe Coding 成了全行业最热的话题。6个月后，当我们回过头来拉一份真实账本，发现事情远没有"一句话生成一个App"那么浪漫。本文从产品经理和研发两个…
华为OD机试2025C卷-字符统计及重排[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率
📫 个人主页：深夜coding算法 📣 专栏系列：2026年华为最新OD机试题库详解 🔥 一次订阅，永久解锁 | 持续更新100篇 | 6语言全覆盖 文章目录❄️前言：☀️一：题目描述🌙 题目…
华为OD机试2025C卷-寻找相同子串[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率
📫 个人主页：深夜coding算法 📣 专栏系列：2026年华为最新OD机试题库详解 🔥 一次订阅，永久解锁 | 持续更新100篇 | 6语言全覆盖 文章目录❄️前言：☀️一：题目描述🌙 题目…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…