2 - 路由层 on Apache Dubbo

2-1 - 路由选址执行失败

Mon, 01 Jan 0001 00:00:00 +0000

路由选址执行失败

2-2 - 没有可用的 Provider（地址找不到）

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

Provider 服务没启动，或者注册中心（比如 ZooKeeper，Nacos，Consul）宕机了。
Dubbo 的服务配置有误差，必须保证服务名，组别（默认是 Dubbo），version 三者都正确。
访问的环境有误：通常我们会有开发环境、测试环境、线上生产环境等多套环境。有时候发布的服务到了测试环境，而访问调用时却走了开发环境。

排查和解决步骤

访问注册中心的 Ops 系统，查询对应的服务是否有提供者列表；同时检查调用者应用所在服务器的日志(一般每种注册服务的客户端都会有对应的日志记录)，查看是否有地址信息的推送/拉取记录。
如无，则表明发布者发布服务失败，检查发布者的应用启动是否成功。
如有服务，则检查调用者应用所连接的注册中心，确认跟预期的环境要匹配。
如上述都没有问题，检查是否配置了路由过滤的规则等。

这个错误码的 FAQ 页面参考了空冥同学的《Dubbo 常见错误及解决方法》。

所引文章通过 CC-BY-4.0 协议赋予了汇编的权利。在此向原作者表示感谢。

2-3 - 路由关闭失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

用户自定义路由未按规范编写。

排查和解决步骤

参照社区SPI扩展使用手册，检查用户自定义路由《SPI 扩展使用手册》。

2-4 - Merger接口加载失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

Dubbo 提供了聚合下游所有提供方响应的 SPI 扩展 Merger 接口，Dubbo 在加载用户在自定义扩展 Merger 接口时，加载配置失败。

排查和解决步骤

参照社区 SPI 扩展使用手册，检查用户自定义扩展 Merger 接口实现《SPI 扩展使用手册》。

2-5 - 筛选提供方失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

Dubbo 在负载均衡时会从提供方列表中最终选择一个提供方发起调用，在选择过程中提供方列表变动，发生读写冲突，导致筛选异常。
Dubbo 重试机制在调用提供方失败时，会重新筛选另一个提供方发起调用，重新筛选过程发生异常。

排查和解决步骤

检查注册中心提供方列表，与对应提供方可用性。
在社区提 Issue，提供环境现场信息及复现步骤。

2-6 - 条件路由筛选提供方列表为空

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

条件路由提供方过滤条件为空。
条件路由在强制降级下筛选提供方列表仍为空。

排查和解决步骤

参照社区请求路由示例，调整条件路由配置。

2-7 - 条件路由执行异常

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

条件路由规则未按照规范配置，导致执行条件路由筛选时执行异常。

排查和解决步骤

参照社区请求路由示例。

2-8 - 提供方返回异常响应

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

提供方自身处理结果抛出异常。

排查和解决步骤

检查提供方程序是否正常。

2-9 - 增加超时检查任务失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

Dubbo 框架会对请求调用增加一个超时检查任务，增加超时检查任务失败。

排查和解决步骤

该异常为 Dubbo 框架自身异常，请在社区提 Issue ，提供环境现场信息及复现步骤。

2-10 - 调用服务提供方失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

Dubbo 调用服务提供方失败，并开始重试。
Dubbo 重试调用服务提供方持续失败。
Dubbo 重试调用服务提供方达到上限。

排查和解决步骤

检查消费方提供方之间网络连接耗时等网络资源。
通过 telnet 等手段检查提供方对应端口是否能正常响应。
检查提供方程序是否运行正常。

2-11 - 标签路由规则不合法

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

用户配置的标签路由规则不合法。
用户配置的标签路由地址不合法。

排查和解决步骤

参照社区标签路由配置规范，检查标签路由配置。

2-12 - 标签路由获取提供方应用名为空

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

标签路由从推送提供方地址列表中获取提供方应用名为空。

排查和解决步骤

该异常为 Dubbo 框架自身异常，请在社区提 Issue ，提供环境现场信息及复现步骤。

2-13 - 接收加载mesh的路由规则失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

mesh 路由配置的规则不合法，加载异常。

排查和解决步骤

检查 mesh 路由规则配置。mesh示例。

2-14 - 脚本路由执行失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

脚本路由规则不合法，导致规则解析失败。
Dubbo 框架执行脚本失败。

排查和解决步骤

检查脚本是否按照规范编写。

2-15 - 路由规则解析失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

用户配置的路由规则不合法。

排查和解决步骤

排查配置的路由规则。

2-16 - 请求重试多次失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

提供方异常，导致消费方重试多次失败。

排查和解决步骤

排查提供方健康状况。

2-17 - mock请求失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

配置了强制 mock，提示性日志。
执行 mock 请求异常。

排查和解决步骤

检查是否配置了强制 mock。
检查 mock 响应是否正常。

2-18 - mesh路由规则未被监听

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

mesh 下发了路由规则，但是该规则未被监听。

排查和解决步骤

检查 mesh 路由规则配置是否符合规范。

2-19 - 异步请求失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

提供方异常，导致消费方异步请求失败。
网络异常，导致消费方异步请求失败。

排查和解决步骤

排查提供方健康状况。
排查网络状况。

2-20 - 获取分组结果合并时失败

Mon, 01 Jan 0001 00:00:00 +0000

可能的原因

获取分组结果合并时失败。

排查和解决步骤

返回结果时，可能出现业务逻辑上的运行时异常，可根据控制台指定的代码行数进行回溯定位。