跳转到内容
Max / Knowledge

Dubbo

Difficulty
Advanced
Status
Stable
Last reviewed
2026年8月

Dubbo 把一次远程调用拆成可替换的扩展点：配置层组装服务，注册中心提供地址，Cluster 负责治理与容错，Protocol/Remoting 负责传输。阅读重点不是记住某个协议，而是看清“扩展加载 + Invoker 链 + URL 元数据”如何把这些层串起来。

本册问题地图

Section titled “本册问题地图”

Dubbo 的主线不是“调用一个接口”，而是把一次调用逐层变成可治理的 Invoker：

  1. SPI 为什么重要？ 它把协议、注册中心、序列化和负载均衡变成可替换扩展；但包装器、自适应扩展和依赖注入也让真正执行的对象不一定是配置里看到的那个类。
  2. 服务导出和服务引用为什么都围绕 Invoker？ 本地实现和远程代理最终都提供统一调用接口，因此过滤器、监控、集群容错可以复用；代价是排障必须区分代理、路由、Invoker、协议和连接层。
  3. Directory、Router、LoadBalance、Cluster 各自决定什么？ Directory 给候选地址，Router 做约束过滤，LoadBalance 选一次调用的目标，Cluster 决定失败后是否重试、快速失败或转移。
  4. Failover 为什么可能放大故障？ 重试能提高成功率，却可能重复执行非幂等写操作，还会把下游变慢进一步放大成雪崩。
  5. 注册中心变更如何进入请求链？ 订阅回调先更新目录，再影响路由和选择；因此地址已变更不等于下一次请求立刻使用新列表。
  6. 协议层到底承担什么？ 编解码只负责字节与请求对象转换，连接复用、异步响应和线程派发共同决定一次调用何时完成。

版本快照

Section titled “版本快照”
项 值
仓库 apache/dubbo
本地路径 E:\source\java\rpc\dubbo
分支 3.3
Commit 3a3043227f5571d25eb2889de5bca22f2914843b（2026-07-28）
最近 tag dubbo-3.3.6

本册所有 文件:行号 坐标均基于上述 commit，上游演进后行号可能漂移。

它解决什么问题

Section titled “它解决什么问题”
  • 将本地接口调用映射为可治理的远程调用，并允许协议、序列化、注册中心和负载均衡独立替换。
  • 在服务地址变化、节点失败和请求重试时，把业务代码与基础设施故障隔离。
  • 让同一套调用模型覆盖传统 Dubbo 二进制协议、Triple/HTTP、Injvm 等不同传输。

模块地图

Section titled “模块地图”
模块 职责 关键抽象
dubbo-common URL、SPI、线程模型与基础工具 ExtensionLoader、URL
dubbo-config Spring/Java 配置转运行时对象 ServiceConfig、ReferenceConfig
dubbo-registry 注册、订阅和地址变更 Registry、ServiceDiscovery
dubbo-cluster 目录、路由、负载均衡、容错 Directory、ClusterInvoker
dubbo-rpc Invoker、Protocol、代理与协议实现 Invoker、Protocol
dubbo-remoting Transport、Exchange、Codec Exchangers、ExchangeHandler

读码入口顺序

Section titled “读码入口顺序”
  1. ExtensionLoader#getExtension：先理解 Dubbo 的 SPI、包装器、依赖注入和自适应扩展。
  2. ServiceConfig#export 与 ReferenceConfig#get：观察配置如何变成 Exporter/Invoker。
  3. AbstractClusterInvoker#invoke：从 Directory 列表进入路由、选择和重试。
  4. DubboProtocol#export/refer：进入 Exchange、客户端连接和请求处理。
  5. DubboCodec 与 HeaderExchangeHandler：追踪字节、请求、响应和 Future 的转换。

本册目录

Section titled “本册目录”

横向对照

Section titled “横向对照”
对象 对照点
Spring BeanFactory 都用扩展点和后置处理，但 Dubbo 的核心产物是 Invoker 链
Spring Cloud OpenFeign 都把接口调用代理成远程请求，Dubbo 的 Cluster/Registry 治理层更内聚
Netty Dubbo Remoting 借助传输抽象承载请求，Netty 只是一种底层实现
RocketMQ 都用 URL/元数据和可插拔组件隔离运行时差异，但 Dubbo 的一致性目标是调用治理
Section titled “Related”