Apache Dubbo
文档
联系社区
新闻
安全公告
贡献者指南
博客
下载
生态
代码生成
可视化控制台
无代理网格
更多样例
EN
中文
EN
GITHUB
文档
联系社区
新闻
安全公告
贡献者指南
博客
下载
生态
代码生成
可视化控制台
无代理网格
更多样例
介绍
概念与架构
与 gRPC、Spring Cloud、Istio 关系
功能
微服务开发
服务发现
负载均衡
流量管控
路由机制介绍
条件路由
标签路由
脚本路由
动态配置
限流 & 熔断
Mesh 路由
通信协议
扩展适配
观测服务
认证鉴权
服务网格
微服务生态
更多高级功能
核心优势
快速易用
超高性能
服务治理
生产环境验证
用户手册
Java SDK
版本信息
快速入门
创建基于Spring Boot的Dubbo应用
部署Dubbo应用
使用教程
快速创建应用
Spring Boot Starter
纯 API 开发模式
通信协议
选择 RPC 协议
dubbo协议
triple协议
Java接口方式
Protobuf(IDL)方式
Streaming流式通信
发布/调用标准gRPC服务
rest协议
服务发现
服务发现
负载均衡
使用Zookeeper注册中心
使用Nacos注册中心
使用Kubernetes注册中心
观测服务
控制台
Prometheus
Grafana
日志管理
全链路追踪
链路追踪
OpenTelemetry
Zipkin
Skywalking
打包部署
传统注册中心
Kubernetes
服务网格
流量管控
示例应用架构
调整超时时间
服务重试
访问日志
同区域优先
环境隔离
基于条件的流量路由
参数路由
权重比例
服务降级
固定机器导流
RPC框架
Server与Client
线程模型
Filter拦截器
超时时间
异步调用
版本与分组
传递附加参数
集群容错(重试)
泛化调用
更多特性
泛化实现
回声测试
运行时动态指定 IP 调用
直连提供者
调用触发事件通知
服务端对客户端进行回调
服务降级
本地存根
本地调用
并发控制
连接控制
主机配置
调用结果缓存
服务引用配置对象缓存
路由状态采集
参数校验
响应式编程
自定义扩展
如何自定义扩展
Filter
Protocol
Registry
Router
分布式事务
使用Seata让Dubbo支持分布式事务
HTTP网关接入
基本架构
dubbo协议
triple协议
限流降级
Sentinel限流
框架内置限流
自适应限流
安全策略
类检查机制
权限控制
TLS支持
服务鉴权
故障排查
请求耗时采样
应用启动失败
地址找不到异常
请求成功率低
参考手册
配置说明
Spring
Spring Boot
XML 配置
原生API
API 配置
Maven Plugin 配置
配置加载流程
配置项手册
序列化协议
序列化概述
triple
Protobuf
Protobuf Wrapper
dubbo
Hessian
Fastjson2
Fastjson
Avro
FST
Gson
Kryo
MessagePack
序列化协议升级
RPC协议
协议概述
triple
dubbo
多协议
tripe-3.3新特性
triple-rest用户手册
扩展实现
Redis 协议
Thrift 协议
Memcached 协议
Rest 协议
Rmi协议
Hessian协议
Webservice协议
注册中心与服务发现
注册中心概述
zookeeper
nacos
多注册中心
应用级vs接口级
扩展实现
Multicast
Consul
Etcd
Redis
配置中心
配置中心概述
Zookeeper
Nacos
Apollo
扩展实现
元数据中心
元数据中心概述
Nacos
Zookeeper
扩展实现
性能Benchmark
RPC 基准
RPC 控制台
应用级服务发现基准
GraalVM
支持 GraalVM Native Image
SPI插件扩展点
SPI 概述
SPI 插件列表
部分重点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 - 程序被打断
错误码机制的介绍
升级和兼容性
升级到Dubbo3
升级到triple协议
升级到应用级服务发现
版本变更记录
2.x 升级至 3.x
3.0 升级至 3.1
3.1 升级至 3.2
3.2 升级至 3.3
Golang SDK
版本信息
框架介绍
快速开始
开发RPC服务
开发微服务应用
使用教程
RPC框架
流式通信
超时时间
健康检查
请求重试
通信协议
异常类型返回值
传递附加参数
启动时检查
filter拦截器
地址发现
使用 Nacos 作为注册中心
使用 Zookeeper 作为注册中心
多注册中心
负载均衡
负载均衡
配置文件
本地配置文件
远程配置文件
可视化观测
框架日志
metrics监控
全链路追踪
流量管控
路由规则
Sentinel限流降级
HTTP网关接入
接入 Ingress 流量
使用 Pixiu 暴露 Dubbo-go 服务
分布式事务
Seata分布式事务
与dubbo-java互通
protobuf+triple 协议互通
非protoubf模式协议互通
服务发现实现地址互通
与grpc互通
与 gRPC 应用互通
参考手册
生态组件
泛化调用
使用 dubbogo-cli 工具
源码解读
网络协议
注册中心
新特性
泛化调用
泛化调用
AOP 与可扩展机制
Dubbo的应用和接口
架构
使用 Nacos 作为注册中心
Node.js SDK
快速开始
Web SDK
Web浏览器访问Dubbo服务
Rust SDK
快速开始
Rust和Java互相调用
服务发现
服务路由
Streaming通信模型
使用Unix套接字连接器通信
Python SDK
快速开始
自定义序列化
Streaming 通信模型
服务发现
Erlang SDK
快速开始
消费者配置
提供者配置
序列化配置项
服务网格
入门介绍
核心功能
流量管理
安全
可观测性
proxyless 模式
安装
Dubboctl
Helm
平台安装
任务
流量管理
ingress
Kubernetes Gateway API
安全
可观测性
升级
其他
Pixiu Gateway
概述
Gateway API
Gateway API 扩展
PixiuClusterPolicy
PixiuFilterPolicy
PixiuGatewayPolicy
安装
Kubernetes
Helm
任务
快速开始
流量管理
HTTP
AI Gateway
配置 MCP
配置上游 endpoint
注册服务到网关
其他
用户文档
快速开始
启动 dubbo-go-pixiu
API 模型介绍
配置文件
启动和配置
部署操作
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 介绍
Metric 介绍
Opa 介绍
RateLimiter 介绍
断路器介绍
案例介绍
Http Proxy 案例介绍
Dubbo案例
Dubbo URI
Dubbo 查询
Dubbo 错误
Dubbo 混合多个部分获取参数
Dubbo 结合
Dubbo 请求体
Dubbo 数据不完整
Dubbo 通用请求
Dubbo 运行简单例子
Dubbo 案例
Http to Dubbo 案例介绍
HTTP案例
GRPC 调用
HTTP 调用
mock 案例介绍
SpringCloud
其他案例
Auth Filter 快速入门
Fail Inject Filter 快速入门
启动 PrometheusPushGateway
使用 Jaeger 进行追踪
Https 案例介绍
质量指标
稳定性
性能
附录
HTTP to Dubbo 默认转换协议
开发者指南
filter概述
Pixiu Filter体系介绍
dubbo-pilot Control Plane 部署
Trie 前缀树介绍
日志阅读介绍
FAQ
协议规范
Triple 协议规范
Triple 协议优势与目标
Dubbo2 协议规范
HTTP 协议规范
相关指标
标准监控指标
集成适配
Prometheus
Grafana
Skywalking
Zipkin
Nacos
Higress
Zookeeper
提案
Rest 协议
注册&配置&元数据中心
Admin 架构设计
指标埋点
服务柔性
应用级服务发现
Triple协议Http标准能力增强-多Content-Type支持
安全公告
序列化安全
RPC 协议安全
注册中心安全
Dubbo Admin 安全
Log4j 漏洞影响
文档
服务网格
任务
流量管理
ingress
ingress
控制 Dubbo 服务网格的入口流量
Kubernetes Gateway API
学习如何使用 Kubernetes Gateway API
最后修改 December 21, 2025:
add mesh gateway docs (#3171) (227e2604368)
编辑此页
创建子页面
登记问题
提交项目问题