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
多個註冊中心
簡易
元資料中心
元數據中心概述
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 - 無法透過網址下載檔案
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 - 標籤路由獲取 Provider 應用名稱為空
2-13 - 接收並載入 Mesh 路由規則失敗
2-15 - 路由規則解析失敗
2-15 - 腳本路由執行失敗
2-16 - 請求重試多次失敗
2-17 - Mock 請求失敗
2-18 - 未監控 Mesh 路由規則
2-19 - 非同步請求失敗
2-2 - 沒有可用的 Provider(找不到地址)
2-3 - 路由關閉失敗
2-4 - 合併介面載入失敗
2-5 - 篩選 Provider 失敗
2-6 - 條件路由過濾 Provider 列表為空
2-7 - 條件路由執行異常
2-8 - Provider 返回異常回應
2-9 - 新增逾時檢查任務失敗
2-10 - 呼叫服務 Provider 失敗
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 - Payload 超出限制異常
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 指標的指標觀測
查看 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
常見問題解答
5 - 設定中心
5-8 - 協定將使用隨機可用埠
5-8 - 協定將使用隨機可用埠
可能原因
協定指定的埠被佔用,已隨機選擇埠啟動。
故障排除和解決步驟
檢查目前設定的埠是否被其他應用程式佔用。
最後修改日期:2023 年 1 月 3 日:
合併錯誤碼 3-3 至 3-8,6-4 至 99-0。 (#1796) (a687d30ae03)
編輯此頁面
建立子頁面
建立 issue
建立專案 issue
可能原因
故障排除和解決步驟