Apache Dubbo
概覽
SDK 手冊
部落格
下載
初始化工具
English
中文
Java
快速入門
快速部署微服務應用程式
基於 Dubbo API 開發微服務應用程式
使用 Dubbo x Spring Boot 開發微服務應用程式
使用 Dubbo x Spring XML 開發微服務應用程式
IDL 定義
概念與架構
整體架構
程式碼架構
服務發現
服務呼叫
Dubbo Mesh
Triple 協議
進階功能
框架和服務
啟動時檢查
分散式事務
群組聚合
端口協議多工
反應式程式設計
服務版本
叢集容錯
參數驗證
服務群組
非同步呼叫
服務降級
泛化呼叫
串流通訊
執行緒池隔離
呼叫鏈傳遞隱式參數
直連提供者
運行時動態 IP 呼叫
一致性雜湊選址
RPC 呼叫上下文
僅訂閱
呼叫觸發事件通知
多協議
伺服器回呼客戶端
本地偽裝
多個註冊中心
本地存根
迴音測試
呼叫資訊記錄
泛化呼叫
非同步執行
本地呼叫
延遲暴露
僅註冊
分散式事務支援
可觀察性
指標
追蹤
日誌記錄
健康資訊
Kubernetes 探針
文件案例
流量治理
路由規則
配置規則
Mesh 路由規則
動態路由
權重路由
使用案例
藍綠部署
A/B 測試
虛擬服務 (VirtualService)
金絲雀部署 (Canary)
目標規則 (DestinationRule)
診斷
請求耗時採樣
執行緒模型
伺服器端執行緒模型
消費者執行緒模型
路由狀態收集
服務參考配置物件快取
負載平衡
註冊資訊簡化
呼叫結果快取
併發控制
連線控制
延遲連線
黏滯連線
支援 Graal VM
匯出執行緒堆疊
Kryo 和 FST 序列化
提升安全性
Dubbo 類別檢查機制
TLS 支援
存取控制
服務驗證
其他
自訂服務容器
優雅關機
主機地址自訂暴露
日誌框架適配與運行時管理
Kubernetes 探針
Docker 部署
日誌框架配置與使用
參考手冊
配置說明
配置概覽
API 配置
註解配置
XML 配置
配置運作方式
配置項手冊
QOS 操作手冊
QOS 概覽
基本命令手冊
服務管理命令
框架狀態命令
日誌框架運行時管理
效能採樣命令
路由狀態命令
序列化安全審計
RPC 協議
協議概覽
Dubbo 協議
Triple 協議
協議概覽
使用說明
使用 POJO 的方式使用 Triple
在 IDL 中使用 Triple
Dubbo2 協議遷移
串流通訊
REST 協議
gRPC 協議
HTTP 協議
Thrift 協議
RMI 協議
Redis 協議
Hessian 協議
Webservice 協議
Memcached 協議
註冊中心說明
概覽
Zookeeper
Nacos
多播
Redis
多個註冊中心
Simple
元資料中心
元資料中心概覽
Nacos
Zookeeper
Redis
配置中心
Zookeeper
Nacos
Apollo
Mesh 手冊
除錯參考文件
效能參考手冊
應用級服務發現基準測試
RPC 基準測試
SPI 擴充套件手冊
Dubbo SPI 概述
Dubbo SPI 擴充套件實現說明
協定擴充套件
呼叫攔截擴充套件
引用監聽器擴充套件
暴露監聽器擴充套件
叢集擴充套件
路由擴充套件
負載均衡擴充套件
合併結果擴充套件
註冊中心擴充套件
監控中心擴充套件
擴充點載入擴充套件
動態代理擴充套件
就緒探針
啟動探針
存活探針
編譯器擴充套件
配置中心擴充套件
元數據中心擴充套件
訊息派發擴充套件
執行緒池擴充套件
序列化擴充套件
網路傳輸擴充套件
資訊交換擴充套件
網路擴充套件
點對點網路節點建構器擴充套件
Telnet 命令擴充套件
狀態檢查擴充套件
容器擴充套件
快取擴充套件
驗證擴充套件
日誌適配擴充套件
QoS 匿名存取驗證擴充套件
擴充點開發指南
升級相容性
2.x 至 3.x 操作指南
Dubbo 協定遷移至 Triple 協定指南
3.1 升級至 3.2
應用級服務發現
應用級服務發現遷移範例
介面級服務發現遷移至應用級服務發現指南
應用級服務發現位址遷移規則
序列化協定升級指南
Protobuf 與介面
3.0 至 3.1 操作指南
常見問題
0 - 常見問題
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 - I/O 串流例外
0-23 - 序列化資料轉換例外
0-24 - 覆寫欄位值例外
0-25 - 載入映射失敗
0-26 - 發佈元數據服務時的警告訊息
0-27 - 執行緒池隔離配置例外
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 - 元數據伺服器故障
1-18 - 未提供元數據服務埠
1-19 - K8S 監控例外
1-20 - K8S Pod 不存在
1-21 - K8S 沒有可用的服務
1-22 - K8S 配置位址錯誤
1-23 - 無法透過 URL 下載檔案
1-24 - ZK 啟動例外
1-25 - ZK 銷毀異常
1-26 - xDS 憑證產生失敗
1-27 - K8S 監控異常
1-28 - xDS 存根錯誤
1-29 - xDS 讀取檔案失敗
1-30 - xDS 請求失敗
1-31 - xDS 回應失敗
1-32 - xDS 通道初始化失敗
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-11 - 標籤路由規則不合法
2-12 - 標籤路由獲取提供者應用名稱為空
2-13 - 接收和載入網格路由規則失敗
2-15 - 路由規則解析失敗
2-15 - 腳本路由執行失敗
2-16 - 請求重試多次失敗
2-17 - 模擬請求失敗
2-18 - 未監控網格路由規則
2-19 - 非同步請求失敗
2-2 - 無可用提供者（找不到地址）
2-3 - 路由關閉失敗
2-4 - 合併介面載入失敗
2-5 - 過濾提供者失敗
2-6 - 條件路由過濾器提供者清單為空
2-7 - 條件路由執行異常
2-8 - 提供者返回異常回應
2-9 - 增加逾時檢查任務失敗
2-10 - 呼叫服務提供者失敗
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 - 無法獲取環境變數
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-19 - 內嵌 ZooKeeper 運行異常
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 無權限存取
99 - 未知
99-1 - 程式中斷
99-0 - 內部未知錯誤
錯誤碼機制介紹
Golang
前言
什麼是 Dubbo-go
概念
泛化呼叫
多語言 RPC
網路協定
服務註冊與發現
Dubbo-go 3.0 的新特性
架構
AOP 與擴充機制
架構
Dubbo 的應用與介面
Dubbo-go 範例
快速入門
安裝 Dubbo-go 開發環境
完成一個 RPC 呼叫
完成一個 RPC 呼叫（自行定義介面的版本）
任務
開發服務
套用模板
註冊中心
理解註冊中心
應用級服務發現
註冊中心配置
使用 Nacos 作為註冊中心
使用 Nacos 作為註冊中心
使用 Zookeeper 作為註冊中心
使用 Polaris 作為註冊中心
多個註冊中心
協定配置
Triple 異常返回
異常資訊返回
選擇要使用的網路協定
異構系統互通性
與 Java 應用程式跨語言互通
與 gRPC 應用程式互通
配置中心
配置中心介紹
Dubbogo 3.0 配置中心與配置監控
遠端載入配置啟動
進階功能
使用配置 API 啟動應用程式
日誌
使用 ctx 傳遞上下文資訊
泛化呼叫
泛化呼叫
服務除錯
使用 grpc_cli 除錯 Dubbo-go 服務
服務部署
生產環境部署最佳實務簡介
Docker 鏡像打包教學
Kubernetes 部署教學
服務治理
服務狀態監控
基於 http metrics 的指標觀測
檢視 RPC 呼叫的監控資訊
資料回報 Promethus 教學
基於 Grafana 的視覺化監控教學
Dubbo Go 日誌管理
指標數據回報
全鏈路追蹤
基於 Jaeger 的鏈路追蹤
使用 OpenTelemetry 協定
基於 Skywalking 的追蹤
健康檢查
基於 gRPC 的健康檢查
dubbogo 3.0 啟動時檢查
Kubernetes 探針
流量管理
路由規則
優雅上下線
速率限制
Dubbo Go 內建限流使用教學
基於 Sentinel 的限流教學
基於 Polaris 的限流教學
設定伺服器端限流
dubbogo 3.0 彈性服務
服務網格
部署 Istio 環境
在 Istio 環境中部署 Dubbo-go 應用程式
流量管理
使用 Pixiu 閘道器存取 Ingress 流量
存取 Ingress 流量
使用 Pixiu 暴露 Dubbo-go 服務
無代理服務網格 (Proxyless Service Mesh)
進階功能
自訂服務呼叫中介軟體
設定呼叫逾時
自訂過濾器元件
原始碼解析
網路協定
註冊中心
參考
配置項參考
使用 dubbogo-cli 工具
Dubbogo 生態組件
依賴適配版本號
組態基本概念
Rust
快速入門
Rust 與 Java 互通性
網路協定
Erlang
SDK 手冊
Java
常見問題
2 - 路由
2-1 - 路由地址選擇執行失敗
2-1 - 路由執行失敗
路由地址執行失敗
最後修改日期：2023 年 1 月 2 日：
增強英文文件 (#1798) (95a9f4f6c1c)
編輯此頁面
建立子頁面
建立 issue
建立專案 issue
路由地址執行失敗
