Ark 框架版本信息202601
Ark框架下的核心版本清单。
1. 核心基础设施 (Infrastructure)
| 组件名称 | 推荐版本 | 关键说明 |
|---|---|---|
| Java JDK | 21 (LTS) | 必须使用 JDK 17+，推荐 21 以获得更好的虚拟线程支持。 |
| Spring Boot | 3.4.13 | 当前最新的补丁版本，修复了大量 3.4.0 带来的配置绑定 Bug。 |
| Spring Framework | 6.2.15 | Boot 3.4.13 的内置依赖版本。 |
| Hutool | 5.8.43 (LTS) | 定位于 5.x 终极版，完美兼容 Java 21。 |
2. 接口与文档 (API & Doc)
| 组件名称 | 推荐版本 | 关键说明 |
|---|---|---|
| Knife4j | 4.5.0 | 必须用 knife4j-openapi3-jakarta-spring-boot-starter。 |
| SpringDoc | 2.8.0 | Spring Boot 3 的官方文档适配器，替代原有的 Springfox。 |
| Swagger UI | 5.18.2 | 包含在 SpringDoc 中，提供 OpenAPI 3.0 支持。 |
3. 数据持久化与连接 (Data & Storage)
| 组件名称 | 推荐版本 | 关键说明 |
|---|---|---|
| MyBatis Plus | 3.5.15 | 必须使用 mybatis-plus-spring-boot3-starter。 |
| Druid | 1.2.24 | 必须使用 druid-spring-boot-3-starter。 |
| Redisson | 3.42.0 | 必须使用 redisson-spring-data-34 以适配 Spring Data Redis 3.4。 |
| MySQL Driver | 9.5.0 | 推荐使用最新版本以匹配 MySQL 9.x 协议。 |
4. 工具类与序列化 (Utils & Serialization)
| 组件名称 | 推荐版本 | 关键说明 |
|---|---|---|
| Fastjson2 | 2.0.59 | 必须配合 fastjson2-extension-spring6 使用。 |
| Lombok | 1.18.42 | 确保 IDE 插件已同步更新至最新。 |
| Jackson | 2.18.5 | Boot 默认序列化，建议在通用 SDK 中保持默认。 |
| Maven Compiler Plugin | 3.13.0+ | 必须使用较新版本以支持 annotationProcessorPaths 属性。 |
5. Spring Cloud 核心版本清单 (2024.0.x 系列)
| 组件名称 | 兼容版本 | 关键说明 |
|---|---|---|
| Spring Cloud BOM | 2024.0.3 | 官方 Moorgate 稳定版，原生支持 Spring Boot 3.4.x。 |
| Spring Cloud Alibaba | 2023.0.3.4 | 注意： 适配 Spring Boot 3.4.x 的最新版本。 |
| Nacos Server | 2.4.x / 2.5.x | 建议服务器端版本不低于 2.4.0，以匹配 2026 年的性能需求。 |
| Sentinel | 1.8.8+ | 确保控制台与客户端通信协议兼容 Jakarta EE。 |