【2025 RuoYi-Cloud-Plus】技术栈汇总

📦 一、Spring 生态核心

Group ID	Artifact ID	Version	类型	说明
org.springframework.boot	spring-boot-dependencies	${spring-boot.version} = 3.5.6	BOM	Spring Boot 3.5.6 依赖管理，定义了 Spring Boot 及其生态组件版本
org.springframework.cloud	spring-cloud-dependencies	${spring-cloud.version} = 2025.0.0	BOM	Spring Cloud 2025.0.0（对应 Spring Boot 3.5+），包含 Gateway、LoadBalancer、OpenFeign 等
org.dromara	ruoyi-common-alibaba-bom	${revision} = 2.5.0	BOM	项目自定义的 Spring Cloud Alibaba 组件 BOM（推测包含 Nacos、Sentinel、Seata 等）

✅ 说明：虽然未显式列出 spring-cloud-starter-alibaba-nacos-discovery 等，但子模块中会通过该 BOM 引入。

---

🧩 二、认证与安全

Group ID	Artifact ID	Version	类型	说明
cn.dev33	sa-token-core	1.44.0	Library	Sa-Token 核心库，提供 Token 生成、验证、会话管理
cn.dev33	sa-token-spring-boot3-starter	1.44.0	Starter	Sa-Token 对 Spring Boot 3 的自动配置支持
com.alibaba	fastjson	1.2.83	JSON 库	用于 JSON 序列化/反序列化（⚠️ 已有安全漏洞，建议迁移到 Fastjson2 或 Jackson）
org.bouncycastle	bcprov-jdk15to18	1.80	加密库	提供额外的加密算法（如 SM2/SM3/SM4 国密支持）

---

🗄️ 三、数据访问与 ORM

3.1 MyBatis 生态

Group ID	Artifact ID	Version	类型	说明
org.mybatis	mybatis	3.5.16	ORM 核心	MyBatis 基础框架
com.baomidou	mybatis-plus-spring-boot3-starter	3.5.14	Starter	MyBatis-Plus 对 Spring Boot 3 的集成
com.baomidou	mybatis-plus-jsqlparser	3.5.14	工具	支持动态 SQL 解析（如分页、条件构造器）
com.baomidou	mybatis-plus-annotation	3.5.14	注解	MP 注解（如 @TableName, @TableId）

3.2 多数据源 & 监控

Group ID	Artifact ID	Version	类型	说明
com.baomidou	dynamic-datasource-spring-boot-starter	4.3.1	Starter	支持多数据源自动切换（通过 @DS 注解）
p6spy	p6spy	3.9.1	监控代理	拦截 JDBC 调用，打印真实 SQL（用于调试）

3.3 Redis 与分布式锁

Group ID	Artifact ID	Version	类型	说明
org.redisson	redisson-spring-boot-starter	3.51.0	Starter	Redisson 客户端集成，支持分布式对象、队列、锁等
com.baomidou	lock4j-redisson-spring-boot-starter	2.2.7	Starter	基于 Redisson 实现的注解式分布式锁（@Lock4j）

3.4 搜索引擎

Group ID	Artifact ID	Version	类型	说明
org.dromara.easy-es	easy-es-boot-starter	3.0.0	Starter	Easy-Elasticsearch，简化 ES 操作（类似 MyBatis-Plus 风格）

3.5 工作流引擎

Group ID	Artifact ID	Version	类型	说明
org.dromara.warm	warm-flow-mybatis-plus-sb3-starter	1.8.1	Starter	Warm-Flow 工作流引擎（国产），基于 MyBatis-Plus + Spring Boot 3
org.dromara.warm	warm-flow-plugin-ui-sb-web	1.8.1	Web 插件	提供流程设计器前端集成

---

📡 四、消息与异步

Group ID	Artifact ID	Version	类型	说明
org.apache.rocketmq	rocketmq-spring-boot-starter	2.3.4	Starter	RocketMQ 官方 Spring Boot 集成（支持消息发送/消费）
com.aizuda	snail-job-client-starter	1.8.0	Starter	SnailJob 分布式任务调度客户端
com.aizuda	snail-job-client-job-core	1.8.0	Core	SnailJob 核心执行逻辑

---

🌐 五、API 与文档

Group ID	Artifact ID	Version	类型	说明
io.swagger.core.v3	swagger-annotations	2.2.36	注解	OpenAPI 3 注解（如 @Operation, @Schema）
org.springdoc	springdoc-openapi-starter-webmvc-api	2.8.13	Starter	SpringDoc（Swagger UI 替代方案），自动生成 OpenAPI 文档
com.github.therapi	therapi-runtime-javadoc	0.15.0	APT + Runtime	在运行时保留 JavaDoc 内容，用于 API 文档增强
com.github.therapi	therapi-runtime-javadoc-scribe	0.15.0	APT	编译期处理器，生成运行时 JavaDoc 数据

---

🛠️ 六、工具类库

Group ID	Artifact ID	Version	类型	说明
cn.hutool	hutool-bom	5.8.40	BOM	Hutool 工具库版本管理（涵盖日期、加密、HTTP、IO 等）
cn.idev.excel	fastexcel	1.3.0	Library	轻量级 Excel 读写（基于流式，低内存）
org.apache.velocity	velocity-engine-core	2.3	模板引擎	用于代码生成模板（如 MyBatis XML、Controller）
org.lionsoul	ip2region	2.7.0	Library	离线 IP 地址库（支持国家/省份/城市查询）
me.zhyd.oauth	JustAuth	1.16.7	Library	第三方登录（微信、QQ、钉钉、GitHub 等）
redis.clients	jedis	5.1.0	Client	Redis 客户端（Dubbo 或某些场景备用，主用 Redisson）

---

🗺️ 七、对象映射（DTO/Entity 转换）

Group ID	Artifact ID	Version	类型	说明
io.github.linpeilie	mapstruct-plus-spring-boot-starter	1.5.0	Starter	MapStruct 增强版，支持链式调用、泛型等
io.github.linpeilie	mapstruct-plus-processor	1.5.0	APT	编译期生成映射实现类
org.projectlombok	lombok-mapstruct-binding	0.2.0	APT 辅助	解决 Lombok 与 MapStruct 编译顺序冲突

---

📝 八、日志与可观测性

Group ID	Artifact ID	Version	类型	说明
net.logstash.logback	logstash-logback-encoder	7.4	Encoder	将日志结构化为 JSON，供 Logstash/ELK 收集
org.apache.skywalking	apm-toolkit-logback-1.x	9.3.0	Integration	SkyWalking 链路 ID 注入日志
org.apache.skywalking	apm-toolkit-trace	9.3.0	API	手动埋点 API（如 TraceContext.traceId()）

---

☁️ 九、云存储（OSS）

Group ID	Artifact ID	Version	类型	说明
software.amazon.awssdk	s3	2.28.22	SDK	AWS S3 客户端（兼容阿里云 OSS、MinIO 等 S3 协议）
software.amazon.awssdk	s3-transfer-manager	2.28.22	SDK	高性能 S3 上传/下载管理器（支持分片、并发）
software.amazon.awssdk	netty-nio-client	2.28.22	HTTP Client	AWS SDK 底层 Netty 实现（虽注释说“移除”，但实际仍引入）

---

📞 十、短信服务

Group ID	Artifact ID	Version	类型	说明
org.dromara.sms4j	sms4j-spring-boot-starter	3.3.4	Starter	国产短信平台集成（支持阿里云、腾讯云、华为云等）

---

🔧 十一、编译与构建（Plugins & APT）

这些虽非运行时依赖，但对开发至关重要。

Group ID	Artifact ID	Version	用途
org.projectlombok	lombok	1.18.40	APT：生成 getter/setter/toString 等
org.springframework.boot	spring-boot-configuration-processor	3.5.6	APT：为 @ConfigurationProperties 生成元数据
com.github.therapi	therapi-runtime-javadoc-scribe	0.15.0	APT：生成运行时 JavaDoc
io.github.linpeilie	mapstruct-plus-processor	1.5.0	APT：生成 MapStruct 映射代码
org.projectlombok	lombok-mapstruct-binding	0.2.0	APT 顺序协调

---

📁 十二、项目内部模块（BOM & Modules）

类型	名称	说明
BOM	ruoyi-common-bom	项目内部通用工具、常量、异常等版本管理
BOM	ruoyi-api-bom	API 接口 DTO、Feign Client 等版本管理
Modules	ruoyi-auth, ruoyi-gateway, ruoyi-modules…	7 个子模块，构成完整微服务架构

---

📌 总结统计

• 总依赖项（不含 BOM 内部）：约 45+ 个独立 artifact
• Starter 类：≥15 个（Spring Boot 风格自动配置）
• APT（编译期处理器）：5 个（Lombok、MapStruct、Therapi、Config Processor）
• 国产组件占比：极高（Sa-Token、Hutool、MyBatis-Plus、SnailJob、Warm-Flow、ip2region、sms4j、Easy-ES 等）
• 许可证：全部为 MIT / Apache 2.0 / BSD 等宽松开源协议（项目本身为 MIT）

---