Apache Dubbo
文档
博客
版本发布
联系社区
Initializer
Github
中文
English
主页
入门
Java
快速部署一个微服务应用
Dubbo Spring Boot Starter 开发微服务应用
Go
安装 Dubbo-go 开发环境
完成一次 RPC 调用
完成一次自己定义接口的 RPC 调用
Rust
Node.js
介绍
概念与架构
与 gRPC、Spring Cloud、Istio 关系
核心优势
快速易用
超高性能
服务治理
生产环境验证
功能
微服务开发
服务发现
负载均衡
流量管控
条件路由
标签路由
脚本路由
动态配置
限流 & 熔断
通信协议
扩展适配
观测服务
认证鉴权
服务网格
微服务生态
更多高级功能
任务
开发服务
生成项目
发布和调用 Dubbo 服务
Provider端和Consumer端异步调用
版本与分组
上下文参数传递
泛化调用
IDL开发服务
部署服务
部署到虚拟机
部署到 Docker
部署到 Kubernetes + Docker
部署到 Kubernetes + Containerd
流量管控
调整超时时间
服务重试
访问日志
同区域优先
环境隔离
参数路由
权重比例
服务降级
固定机器导流
微服务生态
事务管理
HTTP网关
配置中心
元数据中心
注册中心
观测服务
Admin
全链路追踪
OTlp
Zipkin
Skywalking
Grafana
Prometheus
通信协议
开发 Dubbo2 服务
开发 gRPC 服务
开发 Triple 服务
开发 Web 应用
调用 Spring Cloud
单端口多协议
限流降级
Sentinel 限流
Hystrix 熔断降级
Resilience4j
自定义扩展
Filter
Protocol
Registry
Router
故障排查
应用启动失败
地址找不到异常
请求成功率低
SDK 用户手册
Java SDK
快速入门
快速部署一个微服务应用
基于 Dubbo API 开发微服务应用
基于 Spring Boot Starter 开发微服务应用
基于 Spring XML 开发微服务应用
IDL 定义跨语言服务
高级特性和用法
框架与服务
端口协议复用
分布式事务
分组聚合
服务分版本
启动时检查
响应式编程
参数校验
服务分组
集群容错
服务降级
异步调用
泛化调用
流式通信
线程池隔离
调用链路传递隐式参数
运行时动态指定 IP 调用
直连提供者
RPC调用上下文
服务接口JSON兼容性检测
一致性哈希选址
只订阅
调用触发事件通知
多协议
服务端对客户端进行回调
本地伪装
多注册中心
本地存根
回声测试
调用信息记录
泛化调用
异步执行
本地调用
延迟暴露
只注册
分布式事务支持
可观测性
Metrics
链路追踪
日志管理
流量治理
诊断与调优
请求耗时采样
线程模型
服务端线程模型
消费端线程模型
服务引用配置对象缓存
路由状态采集
负载均衡
注册信息简化
调用结果缓存
并发控制
自适应限流
连接控制
延迟连接
粘滞连接
支持 GraalVM Native Image
导出线程堆栈
Kryo 和 FST 序列化
提升安全性
TLS支持
类检查机制
权限控制
服务鉴权
其他
自定义服务容器
优雅停机
主机地址自定义暴露
日志框架适配及运行时管理
Kubernetes 生命周期探针
Dubbo 部署 Docker 环境
日志框架配置与使用
Triple 协议
使用 IDL + Protobuf 跨语言定义服务
Pojo 序列化兼容模式
Streaming 通信模式
参考手册
配置说明
配置概述
API 配置
Annotation 配置
XML 配置
配置工作原理
配置项手册
源码架构
代码架构
服务调用
QOS 操作手册
QOS 概述
基础命令手册
服务管理命令
框架状态命令
日志框架运行时管理
性能采样命令
路由状态命令
序列化安全审计
默认监控指标命令
RPC 协议
协议概述
Dubbo协议
Triple协议
协议概述
IDL 方式使用 Triple
POJO 方式使用 Triple
协议使用方式
Dubbo2 协议迁移
Streaming 通信
Rest协议
gRPC协议
HTTP协议
Rest 协议
Thrift协议
Rmi协议
Redis协议
Hessian协议
Webservice协议
Memcached协议
配置中心
Zookeeper
Nacos
Apollo
元数据中心
元数据中心概述
Nacos
Zookeeper
Redis
注册中心
注册中心概述
Zookeeper
Nacos
Multicast
Redis
多注册中心
Simple
Mesh手册
Debug参考文档
性能参考手册
RPC 基准
RPC 控制台
应用级服务发现基准
SPI 扩展使用手册
Dubbo SPI 概述
Dubbo SPI 扩展实现说明
协议扩展
调用拦截扩展
引用监听扩展
暴露监听扩展
集群扩展
路由扩展
负载均衡扩展
合并结果扩展
注册中心扩展
监控中心扩展
扩展点加载扩展
存活探针
动态代理扩展
就绪探针
启动探针
编译器扩展
配置中心扩展
元数据中心扩展
消息派发扩展
线程池扩展
序列化扩展
网络传输扩展
信息交换扩展
对等网络节点组网器扩展
组网扩展
Telnet 命令扩展
状态检查扩展
容器扩展
缓存扩展
验证扩展
日志适配扩展
QoS匿名访问权限验证扩展
扩展点开发指南
序列化
Hessian
Fastjson2
Protobuf
Fastjson
Avro
FST
Gson
Kryo
MessagePack
升级和兼容性
2.x 升级至 3.x
3.0 升级至 3.1
3.1 升级至 3.2
3.2 升级至 3.3
应用级服务发现
应用级服务发现迁移示例
接口级服务发现迁移至应用级服务发现指南
应用级服务发现地址迁移规则
序列化协议升级
Protobuf vs Interface
Dubbo 协议迁移至 Triple 协议
查看历史版本文档
错误码 FAQ
0 - Common 层
0-1 - 线程池资源枯竭
0-2 - 非法属性值
0-3 - 无法访问缓存路径
0-4 - 缓存条目超限
0-5 - 缓存文件大小超限
0-6 - 线程中断异常
0-7 - 未找到反射类
0-8 - 反射失败
0-9 - 通知事件失败
0-10 - 当前调用不在支持
0-11 - 服务停止失败
0-12 - 未知异常
0-13 - 指标收集器发生异常
0-14 - 监控异常
0-15 - 加载扩展类时发生异常
0-16 - 没有可用的执行器
0-17 - 执行器在关闭时发生未知异常
0-18 - 线程池执行器被错误使用
0-19 - 处理任务时发生异常
0-20 - 存储堆栈信息时发生异常
0-21 - 构建的实例过多
0-22 - 输入输出流异常
0-23 - 序列化数据转换异常
0-24 - 覆盖字段值异常
0-25 - 加载映射错误
0-26 - 元数据发布服务时的警告信息
0-27 - 线程池隔离配置异常
0-28 - 危险的行为
0-29 - 未找到Tracer依赖
0-99 - 调用了过时 (Deprecated) 的方法
1 - 注册中心层
1-1 - 地址非法
1-3 - URL 销毁失败
1-4 - 空地址
1-5 - 接收到没有任何参数的 URL
1-6 - 清空URL缓存出错
1-7 - 读写注册中心服务缓存失败
1-8 - 销毁时注销（取消订阅）地址失败
1-9 - 读写注册中心服务缓存失败
1-10 - 读写注册中心服务缓存失败
1-11 - 注册服务实例创建失败
1-12 - “注册服务” 的实例均已销毁
1-13 - 执行重试任务失败
1-14 - 动态配置识别失败
1-15 - 销毁服务失败
1-16 - 存在不支持的类别
1-17 - metadata Server 失效
1-18 - 未提供 metadata service 端口
1-19 - K8S监听异常
1-20 - K8S Pod不存在
1-21 - K8S 无可用服务
1-22 - K8S 配置地址错误
1-26 - xDS 证书生成失败
1-27 - K8S监听异常
1-28 - xDS 存根错误
1-29 - xDS 读取文件失败
1-30 - xDS 请求失败
1-31 - xDS 响应失败
1-32 - xDS Channel 初始化失败
1-33 - xDS 服务发现初始化失败
1-34 - xDS 解析发生错误
1-35 - ZK 异常
1-36 - 未知异常
1-37 - Nacos 异常
1-38 - Socket 连接异常
1-39 - 获取元数据失败
1-40 - 路由等待时间过长
1-41 - Istio 异常
1-42 - Nacos 存在低版本服务
2 - 路由层
2-1 - 路由选址执行失败
2-2 - 没有可用的 Provider（地址找不到）
2-3 - 路由关闭失败
2-4 - Merger接口加载失败
2-5 - 筛选提供方失败
2-6 - 条件路由筛选提供方列表为空
2-7 - 条件路由执行异常
2-8 - 提供方返回异常响应
2-9 - 增加超时检查任务失败
2-10 - 调用服务提供方失败
2-11 - 标签路由规则不合法
2-12 - 标签路由获取提供方应用名为空
2-13 - 接收加载mesh的路由规则失败
2-14 - 脚本路由执行失败
2-15 - 路由规则解析失败
2-16 - 请求重试多次失败
2-17 - mock请求失败
2-18 - mesh路由规则未被监听
2-19 - 异步请求失败
2-20 - 获取分组结果合并时失败
3 - 动态代理层
3-1 - 将地址转换成 Invoker 失败
3-2 - 发布或推送服务失败
3-3 - 通过Javassist生成字节码失败
3-4 - 客户端发送请求超时
3-5 - 异步响应出现异常
3-6 - 代理执行服务发生异常
3-7 - 服务端响应结果超时
3-8 - 代理失败
4 - 协议层
4-1 - 不支持的协议
4-2 - 序列化优化器初始发生错误
4-3 - 接口引用调用失败
4-4 - 非安全序列化方式
4-5 - 流关闭异常
4-6 - 反序列化失败
4-7 - 关闭客户端时发生错误
4-8 - 关闭服务端时发生错误
4-9 - 解析失败
4-10 - Triple 序列化结果失败
4-11 - 发起请求失败
4-12 - 创建Triple流失败
4-13 - 服务端超时
4-14 - 响应结果失败
4-15 - 客户端流监听器
4-16 - 服务已关闭
4-17 - 关闭所有调用程序时发生错误
4-18 - 无法从调用中获取服务模型
4-19 - 参数值有出错的可能
4-20 - 数据解码失败
4-21 - 检测到不安全的序列化数据
5 - 配置（中心）层
5-1 - 配置中心连接失败
5-2 - 注册/注销关闭钩子方法失败
5-3 - 销毁方法调用时发生意外错误
5-4 - 服务接口中找不到方法
5-5 - 无法获得env变量
5-6 - 接口类型的属性冲突
5-7 - 取消导出时发生意外错误
5-8 - 协议将使用随机可用端口
5-9 - 服务配置导出失败
5-10 - 服务的注册接口应用程序映射失败
5-11 - 注册实例错误
5-12 - 刷新实例和元数据错误
5-13 - 无法销毁模型
5-14 - 模型启动错误
5-15 - 模型引用错误
5-16 - 无法找到任何有效的协议
5-17 - 参数值格式错误
5-18 - 通知注册事件失败
5-20 - 停止 dubbo 模块时发生错误
5-21 - 服务销毁时发生异常错误
5-22 - 注册中心在初始化时发生错误
5-23 - 等待导出/引用服务发生异常
5-24 - 异步等待引用服务发生异常
5-25 - 自定义实现发生未定义异常
5-26 - 元数据已导出
5-27 - 内部类API被错误使用
5-28 - 未发现可用注解
5-29 - 扫描包未配置
5-30 - 声明bean定义重复
5-31 - 状态检查错误
5-32 - Apollo 断开连接时发生错误
5-33 - Apollo 配置更新事件发生异常
5-34 - NACOS 发生错误
5-35 - 容器初始化失败
5-36 - 过滤器校验时发生错误
5-37 - 动态配置监听处理发生错误
5-38 - 配置参数未定义
5-39 - Dubbo配置bean初始化器发生错误
5-40 - Dubbo配置bean未找到
5-41 - SSL证书读取失败
5-42 - Dubbo 证书签发失败
5-43 - Dubbo 证书签发连接不安全
6 - 网络传输层
6-1 - 服务端连接失败
6-2 - 客户端超时
6-3 - 网络连接关闭失败
6-4 - 网络通讯层未知异常
6-5 - 网络连接断开失败
6-6 - 不支持的消息
6-7 - 服务端连接失败
6-8 - 返回数据解码失败
6-9 - 服务端连接失败
6-10 - 超过有效载荷限制异常
6-11 - 字符集不被支持
6-12 - ZK客户端销毁时发生错误
6-13 - 流关闭异常
6-14 - 服务端响应失败
6-15 - 跳过未读完的流数据
6-16 - 重连时发生异常
7 - QoS 插件模块
7-1 - QOS 已关闭
7-2 - QOS 已开启
7-3 - 设置超时时间的警告百分比值
7-4 - QOS 服务启动失败
7-5 - QOS 命令未找到
7-6 - QOS 发生未知异常
7-7 - QOS 无权限访问
81 - 单元测试辅助模块（注册中心）
81-1 - ZK 启动异常
81-2 - ZK 销毁异常
81-3 - 通过url无法下载文件
81-4 - 嵌入式ZooKeeper运行异常
99 - 其它未知错误
99-0 - 内部未知错误
99-1 - 程序被打断
错误码机制的介绍
Golang SDK
框架介绍
概念体系
多语言 RPC
泛化调用
服务注册发现
网络协议
新特性
代码架构
AOP 与可扩展机制
Dubbo的应用和接口
架构
快速入门
快速开始
安装 Dubbo-go 开发环境
完成一次 RPC 调用
完成一次自己定义接口的版本 RPC 调用
使用教程
开发服务
应用模板
注册中心
了解注册中心
应用级服务发现
注册中心配置
使用 Nacos 作为注册中心
使用 Nacos 作为注册中心
使用 Zookeeper 作为注册中心
使用 Polaris 作为注册中心
多注册中心
协议配置
Triple 异常回传
异常信息回传
选择使用的网络协议
异构体系互通
与 Java 应用跨语言互通
与 gRPC 应用互通
配置中心
配置中心介绍
Dubbogo 3.0 配置中心和配置监听
远程加载配置启动
高级特性
使用配置 API 启动应用
日志
使用 ctx 传递上下文信息
泛化调用
服务调试
使用 grpc_cli 调试 Dubbo-go 服务
部署服务
生产部署的最佳实践介绍
Docker 镜像打包教程
Kubernetes 部署教程
服务治理
服务状态监控
查看 RPC 调用的监控信息
基于 http metrics 的指标观测
数据上报 Promethus 教程
基于 Grafana 的可视化监控教程
Dubbo Go 日志管理
Metrics 数据上报
全链路追踪
基于 Jaeger 的链路追踪
使用 OpenTelmentry 协议
基于 Skywalking 的追踪
健康检查
基于Grpc的健康检查
dubbogo 3.0 启动时检查
Kubernetes 探针
流量管理
路由规则
优雅下线
限流
Dubbo Go 内置的限流使用教程
基于 Sentinel 的限流教程
基于 Polaris 的限流教程
为服务端设置限流
dubbogo 3.0 柔性服务
服务网格
部署 Istio 环境
Istio 环境部署 Dubbo-go 应用
流量管理
使用 Pixiu 网关接入 Ingress 流量
接入 Ingress 流量
使用 Pixiu 暴露 Dubbo-go 服务
无代理服务网格
高级特性
配置调用的超时
自定义服务调用中间件
自定义Filter组件
源码解读
网络协议
注册中心
参考手册
配置项参考指南
使用 dubbogo-cli 工具
生态组件
版本号
配置基本概念
Dubbo Go Pixiu
入门概述
Pixiu 是什么
Pixiu 术语
Pixiu 常见问题
用户文档
快速开始
启动和配置
部署操作
Listener 介绍
Http Listener 介绍
Http2 Listener 介绍
TCP Listener 介绍
Triple Listener 介绍
Network Filter 介绍
Http NetWorkFilter 介绍
Grpc NetWorkFilter 介绍
Dubbo NetWorkFilter 介绍
Adapter 介绍
Dubbo 集群中心 Adapter
Spring Cloud 集群中心 Adapter
Http Filter 介绍
Dubbo HttpFilter 介绍
RateLimiter 介绍
断路器介绍
案例介绍
Http Proxy 案例介绍
Http to Dubbo 案例介绍
Https 案例介绍
质量指标
稳定性
性能
附录
HTTP to Dubbo 默认转换协议
开发者指南
Pixiu Filter体系介绍
dubbo-pilot Control Plane 部署
Trie 前缀树介绍
Rust SDK
快速开始
Rust和Java互相调用
服务发现
服务路由
Streaming通信模型
使用Unix套接字连接器通信
Erlang SDK
快速开始
消费者配置
提供者配置
序列化配置项
其他
Admin
架构与安装
文档查询
服务测试
服务Mock
Metrics
标准监控指标
集成适配
Prometheus
Grafana
Skywalking
Zipkin
提案
Rest 协议
注册&配置&元数据中心
Admin 架构设计
指标埋点
服务柔性
应用级服务发现
Triple协议Http标准能力增强-多Content-Type支持
协议规范
Triple 协议规范
Triple 协议优势与目标
Dubbo2 协议规范
HTTP 协议规范
安全公告
序列化安全
RPC 协议安全
注册中心安全
Dubbo Admin 安全
Log4j 漏洞影响
文档
SDK 用户手册
Java SDK
错误码 FAQ
4 - 协议层
4-2 - 序列化优化器初始发生错误
4-2 - 序列化优化器初始发生错误
4-2 - 序列化优化器初始发生错误
可能的原因
当前使用了 Kryo 和 FST 的序列化配置。
排查和解决步骤
Kryo 和 FST 序列化
最后修改 March 2, 2023:
Fix alias forward in docs3-v2 (#2342) (f16c153559)
编辑此页
创建子页面
登记问题
提交项目问题
可能的原因
排查和解决步骤
