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 測試
虛擬服務
金絲雀發布
目標規則
診斷
請求耗時採樣
線程模型
服務器端線程模型
消費者線程模型
路由狀態收集
服務引用配置對象緩存
負載均衡
註冊信息簡化
調用結果緩存
併發控制
連接控制
延遲連接
黏性連接
支持 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
多註冊中心
簡易版
元資料中心
元資料中心概覽
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 操作指南
常見問題 (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 - 沒有可用的致動器
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 - Metadata 服務器故障
1-18 - 未提供 metadata 服務端口
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 - 服務品質
7-1 - 服務品質已關閉
7-2 - 服務品質已開啟
7-3 - 設定逾時的警告百分比值
7-4 - 服務品質服務啟動失敗
7-5 - 找不到服務品質命令
7-6 - 服務品質中發生未知異常
7-7 - 服務品質無權限存取
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 作為註冊中心
多個註冊中心
協定設定
三重例外回傳
例外資訊回傳
選擇要使用的網路協定
異質系統互通性
與 Java 應用程式的跨語言互通性
與 gRPC 應用程式互通
配置中心
配置中心簡介
Dubbogo 3.0 配置中心與配置監控
遠端載入配置啟動
進階功能
使用配置 API 啟動應用程式
日誌
使用 ctx 傳遞上下文資訊
泛化呼叫
泛化呼叫
服務除錯
使用 grpc_cli 除錯 Dubbo-go 服務
部署服務
生產環境部署最佳實務簡介
Docker 映像打包教學
Kubernetes 部署教學
服務治理
服務狀態監控
基於 http 指標的指標觀察
檢視 RPC 呼叫的監控資訊
資料回報 Promethus 教學
基於 Grafana 的視覺化監控教學
Dubbo Go 日誌管理
指標資料回報
全鏈路追蹤
基於 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 服務
無代理服務網格 (Proxyless Service Mesh)
進階功能
自訂服務呼叫中介軟體
設定呼叫逾時
自訂過濾器元件
原始碼解析
網路協定
註冊中心
參考
配置項目參考
使用 dubbogo-cli 工具
Dubbogo 生態元件
依賴的調適版本號
配置的基本概念
Rust
快速入門
Rust 與 Java 互通性
網路協定
Erlang
SDK 手冊
Java
常見問題 (FAQ)
0 - 常見問題
0-11 - 服務停止失敗
0-11 - 服務停止失敗
可能原因
連線未及時關閉或記憶體不足,導致服務停止時出現一些異常。
故障排除和解決步驟
在回應內容完成後關閉連線。
最後修改日期:2023 年 1 月 3 日:
合併錯誤碼 3-3 至 3-8,6-4 至 99-0。 (#1796) (a687d30ae03)
編輯此頁面
建立子頁面
建立問題
建立專案問題
可能原因
故障排除和解決步驟