当前位置：首页 > news >正文

ruoyi-vue-pro部署避坑指南：从JDK17到MySQL8的完整配置流程

news 2026/5/27 19:17:16

RuoYi-Vue-Pro全栈部署实战：JDK17与MySQL8深度适配指南

作为一款基于Spring Boot+Vue3的企业级全栈解决方案，RuoYi-Vue-Pro在技术选型上始终紧跟前沿。但这也意味着部署时会遇到许多新版本环境特有的"坑"。本文将带你完整走通从环境准备到前后端联调的部署全流程，特别针对JDK17和MySQL8的兼容性问题给出解决方案。

1. 环境准备：版本选择的艺术

在开始部署前，正确的版本组合能避免80%的兼容性问题。以下是经过验证的黄金组合：

组件	推荐版本	关键说明
JDK	17或21(LTS)	必须≥17，21需注意预览功能开关
MySQL	8.0.28+	需配置新密码策略
Redis	5.0.14.1	Windows推荐此稳定版
Node.js	18.x LTS	16.x已结束维护
pnpm	最新版	比npm/yarn更节省磁盘空间

重要提示：避免使用JDK21的预览功能，编译时添加参数-Dspring-boot.exclude=org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration

实际项目中遇到过因版本错配导致的典型问题：

JDK16+的强封装导致反射报错
MySQL8默认的caching_sha2_password认证方式不兼容旧驱动
Node.js 20+的ESM模块规范变化引发前端构建错误

2. 数据库配置：MySQL8专属优化

2.1 初始化脚本调整

RuoYi-Vue-Pro的SQL脚本需要针对MySQL8做两处关键修改：

-- 修改密码策略（放在脚本首行） SET GLOBAL validate_password.policy=LOW; -- 修改所有timestamp字段定义 ALTER TABLE sys_operate_log MODIFY COLUMN create_time datetime DEFAULT CURRENT_TIMESTAMP;

2.2 连接池配置

在application-dev.yml中需要显式指定时区和SSL模式：

spring: datasource: url: jdbc:mysql://localhost:3306/ruoyi-vue-pro?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true

常见踩坑点：

时区未配置导致时间差8小时
SSL连接未关闭引发握手失败
public key检索未允许导致认证失败

3. 后端工程编译：JDK17的特别处理

3.1 Lombok兼容性方案

在pom.xml中需要锁定lombok版本并添加注解处理器：

<dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.28</version> <scope>provided</scope> </dependency> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <annotationProcessorPaths> <path> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.28</version> </path> </annotationProcessorPaths> </configuration> </plugin> </plugins> </build>

3.2 模块化编译技巧

对于多模块项目，建议按以下顺序编译：

yudao-common
yudao-module-system
yudao-server

使用命令：

mvn clean install -pl yudao-common -am mvn clean install -pl yudao-module-system -am mvn spring-boot:run -pl yudao-server

4. 前端工程调优：Vue3的构建陷阱

4.1 依赖安装加速

使用pnpm时需调整node-linker策略：

# 在项目根目录创建.npmrc echo "node-linker=hoisted" > .npmrc pnpm install --shamefully-hoist

4.2 内存溢出解决方案

在package.json中添加构建参数：

"scripts": { "dev": "NODE_OPTIONS=--max-old-space-size=4096 vite", "build": "NODE_OPTIONS=--max-old-space-size=4096 vite build" }

4.3 跨域配置要点

开发环境proxy配置需匹配后端：

server: { proxy: { '/api': { target: 'http://localhost:48080', changeOrigin: true, rewrite: (path) => path.replace(/^\/api/, '') }, '/upload': { target: 'http://localhost:48080', changeOrigin: true } } }

5. 联调验证：全链路检查清单

当系统启动后，建议按以下顺序验证：

基础接口检查
- GET /api/infra/swagger-ui.html 返回200
- GET /api/system/captcha/enable 返回布尔值
权限系统验证
- 未登录访问/api/system/user/page 返回401
- 登录后访问同一接口返回分页数据
文件上传测试
- POST /api/infra/file/upload 能正确返回URL
- 上传文件能在/resources/static下找到
定时任务检查
- 日志中能看到Job执行记录
- 管理界面能手动触发测试任务