Apache Dubbo
文档
博客
版本发布
联系社区
Initializer
Github
中文
English
介绍
概念与架构
与 gRPC、Spring Cloud、Istio 关系
功能
微服务开发
服务发现
负载均衡
流量管控
条件路由
标签路由
脚本路由
动态配置
限流 & 熔断
通信协议
扩展适配
观测服务
认证鉴权
服务网格
微服务生态
更多高级功能
核心优势
快速易用
超高性能
服务治理
生产环境验证
用户手册
Java SDK
版本信息
快速入门
创建基于Spring Boot的Dubbo应用
快速部署Dubbo应用
使用教程
快速创建应用
Spring Boot Starter
纯 API 开发模式
通信协议
选择 RPC 通信协议
dubbo协议
triple协议
Java接口方式
Protobuf(IDL)方式
Streaming流式通信
发布/调用标准gRPC服务
rest协议
发布REST风格服务
调用Spring Cloud
服务发现
服务发现
负载均衡
使用Zookeeper注册中心
使用Nacos注册中心
使用Kubernetes注册中心
观测服务
控制台
Prometheus
Grafana
日志
待整合-日志管理
待整合-日志框架适配及运行时管理
待整合-日志框架配置与使用
待整合-调用信息记录
全链路追踪
OTlp
Zipkin
Skywalking
链路追踪
打包部署
传统注册中心
Kubernetes
Kubernetes Service
流量管控
调整超时时间
服务重试
访问日志
同区域优先
环境隔离
基于条件的流量路由
参数路由
权重比例
服务降级
固定机器导流
RPC框架
RPC Server & RPC Client
线程模型
Filter拦截器
超时时间
异步调用
版本与分组
传递附加参数
泛化调用
更多特性
响应式编程
参数校验
服务引用配置对象缓存
路由状态采集
服务降级
运行时动态指定 IP 调用
直连提供者
调用结果缓存
调用触发事件通知
服务端对客户端进行回调
本地伪装
本地存根
回声测试
本地调用
服务鉴权
并发控制
连接控制
TLS支持
自定义扩展
Filter
Protocol
Registry
Router
扩展更多组件
分布式事务
使用Seata让Dubbo支持分布式事务
HTTP网关接入
dubbo协议
triple协议
限流降级
待整合-Sentinel 限流
待整合-Hystrix 熔断降级
待整合-集群容错
待整合-Resilience4j
待整合-并发控制
待整合-自适应限流
故障排查
应用启动失败
地址找不到异常
请求成功率低
参考手册
配置说明
Spring
Annotation 配置
XML 配置
原生API
API 配置
配置加载流程
配置项手册
序列化协议
Hessian
类检查机制
Fastjson2
Protobuf
Fastjson
Avro
FST
Gson
Kryo
MessagePack
序列化协议
RPC协议
协议概述
协议概述
Dubbo协议
Rest协议
HTTP协议
Rest 协议
Thrift协议
Rmi协议
多协议
Hessian协议
Webservice协议
注册中心与服务发现
注册中心概述
注册信息简化
Multicast
Redis
多注册中心
配置中心
Zookeeper
Nacos
Apollo
元数据中心
元数据中心概述
Nacos
Zookeeper
Redis
性能参考手册
RPC 基准
请求耗时采样
应用级服务发现基准
GraalVM
Dubbo 集成 Graalvm参考手册
支持 GraalVM Native Image
SPI 扩展使用手册
Dubbo SPI 概述
Dubbo SPI 扩展实现说明
协议扩展
调用拦截扩展
引用监听扩展
暴露监听扩展
集群扩展
路由扩展
负载均衡扩展
合并结果扩展
注册中心扩展
监控中心扩展
扩展点加载扩展
存活探针
动态代理扩展
就绪探针
启动探针
编译器扩展
配置中心扩展
元数据中心扩展
消息派发扩展
线程池扩展
序列化扩展
网络传输扩展
信息交换扩展
对等网络节点组网器扩展
组网扩展
Telnet 命令扩展
状态检查扩展
容器扩展
缓存扩展
验证扩展
日志适配扩展
QoS匿名访问权限验证扩展
扩展点开发指南
单机运维命令(QOS)
QOS 概述
基础命令手册
服务管理命令
框架状态命令
日志框架运行时管理
性能采样命令
路由状态命令
序列化安全审计
默认监控指标命令
源码架构
代码架构
服务调用
错误码 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 - 程序被打断
错误码机制的介绍
升级和兼容性
2.x 升级至 3.x
3.0 升级至 3.1
3.1 升级至 3.2
3.2 升级至 3.3
应用级服务发现
应用级服务发现迁移示例
接口级服务发现迁移至应用级服务发现指南
应用级服务发现地址迁移规则
单端口多协议
序列化协议升级
Protobuf vs Interface
Dubbo 协议迁移至 Triple 协议
Dubbo2 协议迁移
查看历史版本文档
Golang SDK
版本信息
框架介绍
快速开始
快速开始
安装 Dubbo-go 开发环境
完成一次 RPC 调用
完成一次自己定义接口的 RPC 调用
使用教程
服务网格
部署 Istio 环境
Istio 环境部署 Dubbo-go 应用
流量管理
使用 Pixiu 网关接入 Ingress 流量
接入 Ingress 流量
使用 Pixiu 暴露 Dubbo-go 服务
无代理服务网格
RPC框架
流式通信
超时时间
请求重试
传递附加参数
logger
多协议支持
序列化
filter拦截器
地址发现
了解注册中心
应用级服务发现
注册中心配置
使用 Nacos 作为注册中心
使用 Nacos 作为注册中心
使用 Zookeeper 作为注册中心
使用 Polaris 作为注册中心
多注册中心
配置文件
配置中心介绍
Dubbogo 3.0 配置中心和配置监听
使用配置 API 启动应用
远程加载配置启动
可视化观测
查看 RPC 调用的监控信息
Metrics 数据上报
全链路追踪
流量管控
限流
Dubbo Go 内置的限流使用教程
基于 Sentinel 的限流教程
基于 Polaris 的限流教程
为服务端设置限流
dubbogo 3.0 柔性服务
路由规则
优雅下线
健康检查
基于Grpc的健康检查
dubbogo 3.0 启动时检查
Kubernetes 探针
与dubbo-java互通
与 Java 应用跨语言互通
与grpc互通
与 gRPC 应用互通
参考手册
生态组件
泛化调用
使用 dubbogo-cli 工具
源码解读
网络协议
注册中心
新特性
泛化调用
泛化调用
AOP 与可扩展机制
Dubbo的应用和接口
架构
Node.js SDK
快速开始
Web SDK
Web浏览器访问Dubbo服务
Rust SDK
快速开始
Rust和Java互相调用
服务发现
服务路由
Streaming通信模型
使用Unix套接字连接器通信
控制面
架构与安装
文档查询
服务测试
服务Mock
其他
Metrics
标准监控指标
集成适配
Prometheus
Grafana
Skywalking
Zipkin
提案
Rest 协议
注册&配置&元数据中心
Admin 架构设计
指标埋点
服务柔性
应用级服务发现
协议规范
Triple 协议规范
Triple 协议优势与目标
Dubbo2 协议规范
HTTP 协议规范
Erlang SDK
快速开始
消费者配置
提供者配置
序列化配置项
Pixiu gateway
入门概述
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 前缀树介绍
文档
用户手册
Java SDK
参考手册
错误码 FAQ
4 - 协议层
4-2 - 序列化优化器初始发生错误
4-2 - 序列化优化器初始发生错误
4-2 - 序列化优化器初始发生错误
可能的原因
当前使用了 Kryo 和 FST 的序列化配置。
排查和解决步骤
Kryo 和 FST 序列化
最后修改 December 26, 2023:
Update java sdk doc (#2883) (a6d947a45d)
编辑此页
创建子页面
登记问题
提交项目问题
可能的原因
排查和解决步骤
