若依微服务版(RuoYi-Cloud)基于 Spring Cloud Alibaba 生态构建,对基础环境版本有明确依赖要求。以下是官方推荐及实际开发中验证过的配置:
JDK 版本要求
- 最低要求:JDK 17
- 推荐版本:JDK 17 LTS(长期支持版)
- 说明:若依微服务架构深度依赖 Spring Boot 3.x 和 Spring Cloud 2022.x/2023.x,这些框架已强制要求 Java 17+。使用 JDK 8 或 11 会导致编译失败或运行时错误(如
UnsupportedClassVersionError)。
✅ 建议安装 OpenJDK 17(如 Adoptium Temurin、Amazon Corretto 等发行版),避免使用 Oracle JDK 的收费限制。
MySQL 版本要求
- 最低要求:MySQL 5.7.32+
- 推荐版本:MySQL 8.0.x(如 8.0.36+)
- 说明:
- 若依微服务默认使用 MyBatis Plus + Druid 连接池,兼容 MySQL 5.7 和 8.0;
- 部分新特性(如 JSON 类型优化、字符集默认值)在 8.0 下表现更佳;
- 若启用
persistence-api或某些加密功能,需确保驱动版本匹配(推荐使用mysql-connector-j 8.0.x替代旧版mysql-connector-java)。
⚠️ 注意:MySQL 8.0 默认认证插件为
caching_sha2_password,若使用旧版 JDBC 驱动可能报错。请确保项目中使用 8.0.32+ 的mysql-connector-j依赖(若依父工程已内置适配)。
补充建议
| 组件 | 推荐版本 | 备注 |
|---|---|---|
| Maven | 3.8.6+ | 支持 Java 17 编译与依赖解析 |
| Redis | 6.2+ / 7.0+ | 用于分布式 Session 与缓存 |
| Nacos | 2.2.3+ | 服务注册发现与配置中心 |
| Sentinel | 1.8.6+ | 流量控制与熔断降级 |
📌 官方文档参考:https://doc.ruoyi.vip/ruoyi-cloud
💡 实践提示:部署前务必检查pom.xml中<java.version>和数据库驱动版本是否一致,避免“版本错配”导致的启动异常。
如需具体环境搭建脚本或 Docker Compose 示例,我可进一步提供。
CLOUD云枢