Spring Cloud Alibaba
This content is not available in your language yet.
Spring Cloud Alibaba 是一组把 Nacos、Sentinel、RocketMQ 等能力接入 Spring Cloud 契约的适配器集合。
本册问题地图
Section titled “本册问题地图”Spring Cloud Alibaba 的源码重点在“如何把外部中间件能力接入 Spring 扩展点”，而不是重复讲 Nacos、Sentinel 或 RocketMQ 本身：
- 自动配置如何发现并创建适配组件？
- Nacos 配置和服务发现如何映射成 Spring Environment、注册表和事件？
- Sentinel 规则如何进入应用内的限流、熔断和保护链？
- RocketMQ Binder 如何把消息通道、生产者和消费者接入 Spring Cloud Stream？
- 外部系统不可用时，适配层提供什么缓存、降级和重试边界？
读完整册后，应当能区分“上游组件的核心机制”和“Spring Cloud Alibaba 的适配责任”。
| 项 | 值 |
|---|---|
| 仓库 | alibaba/spring-cloud-alibaba |
| 本地路径 | E:\source\java\spring\spring-cloud-alibaba |
| 分支 | 2025.1.x |
| Commit | 115d5901102009492e05d5ec18c3f79cad4077d0（2026-08-04） |
| 最近 tag | 2025.1.0.0 |
本册所有源码坐标均基于上述 commit。
它解决什么问题
Section titled “它解决什么问题”- 把第三方客户端生命周期接入 Spring Boot 自动配置。
- 把 Nacos 配置、服务发现、Sentinel 规则、RocketMQ 消息包装成 Spring Cloud 标准接口。
- 在外部系统不可用时提供缓存、可选导入、错误分析和失败回调。
| 模块 | 适配对象 | Spring 扩展点 |
|---|---|---|
spring-alibaba-nacos-config |
Nacos Config | ConfigDataLocationResolver、ConfigDataLoader |
spring-cloud-starter-alibaba-nacos-discovery |
Nacos Naming | DiscoveryClient、ServiceRegistry |
spring-cloud-starter-alibaba-sentinel |
Sentinel | 自动配置、拦截器、SmartInitializingSingleton |
spring-cloud-starter-stream-rocketmq |
RocketMQ | Spring Cloud Stream Binder |
- 各 starter 的
AutoConfiguration.imports。 - Nacos 配置：
NacosConfigDataLocationResolver->NacosConfigDataLoader。 - Nacos 发现：
NacosDiscoveryClient、NacosServiceRegistry。 - Sentinel：
SentinelAutoConfiguration、SentinelDataSourceHandler。 - RocketMQ：
RocketMQBinderAutoConfiguration->RocketMQMessageChannelBinder。
| 对象 | 对照点 |
|---|---|
| Spring Boot | 复用条件装配、Config Data 与 Environment 扩展点 |
| Spring Cloud OpenFeign | 都把第三方能力包装成标准接口，再延迟创建 |
| Spring Cloud Gateway | Sentinel 以 Web 拦截器/过滤器接入请求边界 |