Apache Dubbo
概覽
SDK 手冊
部落格
下載
初始化工具
English
中文
Java
快速入門
快速部署微服務應用
基於 Dubbo API 開發微服務應用
Dubbo x Spring Boot 開發微服務應用
Dubbo x Spring XML 開發微服務應用
IDL 定義
概念和架構
總體架構
程式碼架構
服務發現
服務呼叫
Dubbo Mesh
Triple 協議
進階功能
框架和服務
啟動時檢查
分散式事務
群組聚合
端口協議多路複用
響應式編程
服務版本
叢集容錯
參數驗證
服務群組
非同步呼叫
服務降級
泛化呼叫
串流通訊
執行緒池隔離
呼叫鏈傳遞隱式參數
直連提供者
運行時動態 IP 呼叫
一致性雜湊站點選擇
RPC 呼叫上下文
僅訂閱
呼叫觸發事件通知
多協議
伺服器回呼客戶端
本地偽裝
多註冊中心
本地 Stub
回顯測試
呼叫資訊記錄
泛化呼叫
非同步執行
本地呼叫
延遲暴露
僅註冊
分散式事務支援
可觀察性
指標
追蹤
日誌記錄
健康資訊
Kubernetes 探針
文件案例
流量治理
路由規則
配置規則
網格路由規則
動態路由
權重路由
用例
藍綠部署
A/B 測試
虛擬服務
金絲雀發布
目標規則
診斷
請求耗時採樣
執行緒模型
伺服器端執行緒模型
消費者執行緒模型
路由狀態採集
服務參考配置物件快取
負載均衡
註冊資訊簡化
呼叫結果快取
併發控制
連接控制
延遲連接
黏性連接
支援 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
多點傳播 (Multicast)
Redis
多註冊中心
簡易版 (Simple)
元資料中心
元資料中心總覽
Nacos
Zookeeper
Redis
配置中心
Zookeeper
Nacos
Apollo
Mesh 使用手冊
除錯參考文件
效能參考手冊
應用級服務發現效能測試
RPC 效能測試
SPI 擴充使用手冊
Dubbo SPI 總覽
Dubbo SPI 擴充實作說明
協定擴充
呼叫攔截擴充
引用監聽器擴充
暴露監聽器擴充
叢集擴充
路由擴充
負載平衡擴充
合併結果擴充
註冊中心擴充
監控中心擴充
擴充點載入擴充
動態代理擴充
就緒探針 (Readiness Probe)
啟動探針 (Start Probe)
存活探針 (Survival Probe)
編譯器擴充
配置中心擴充
元資料中心擴充
訊息派發擴充
執行緒池擴充
序列化擴充
網路傳輸擴充
資訊交換擴充
網路擴充
點對點網路節點建構器擴充
Telnet 命令擴充
狀態檢查擴充
容器擴充
快取擴充
驗證擴充
日誌適配擴充
QoS 匿名存取驗證擴充
擴充點開發指南
升級相容性
2.x 至 3.x 操作指南
Dubbo 協定遷移至 Triple 協定指南
3.1 升級至 3.2
應用級服務發現
應用級服務發現遷移範例
介面級服務發現遷移至應用級服務發現指南
應用級服務發現地址遷移規則
序列化協定升級指南
Protobuf 與介面
3.0 至 3.1 操作指南
常見問題 (FAQ)
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 - 沒有可用的致動器 (Actuator)
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 日誌管理
Metrics 資料回報
全鏈路追蹤
基於 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
常見問題 (FAQ)
2 - 路由
2-3 - 路由關閉失敗
2-3 - 路由關閉失敗
可能原因
使用者自定義路由未按照規範撰寫。
故障排除和解決步驟
參考社群 SPI 擴充套件手冊檢查使用者自定義路由,
“SPI 擴充套件使用手冊”
。
最後修改日期:2023 年 3 月 1 日:
移動 SDK 文件 (#2337) (ceab0ea115a)
編輯此頁面
建立子頁面
建立 issue
建立專案 issue
可能原因
故障排除和解決步驟