服务注册与分布式协调 / 系统课时

排查发现正常却调用失败

排查发现正常却调用失败

服务能在 Nacos 中被发现,只能证明注册中心返回了实例,并不能证明调用链已经可用。本篇按“实例数据 → 健康状态 → 网络端口 → HTTP 接口 → 负载均衡”逐层缩小范围,最终判断问题究竟在注册信息、实例本身还是调用端。

学习目标

  • 能把“发现成功”和“调用成功”拆成可验证的独立环节
  • 能用实例列表与直连请求判断故障位于注册中心、网络还是应用层
  • 能识别端口、健康状态和负载均衡导致的典型“能发现但调不通”

先把调用链拆开

一次基于服务名的调用至少经过五个环节:调用方从 Nacos 获取实例列表,筛掉不可用实例,负载均衡器选中一个地址,网络连接到目标端口,最后由目标应用处理具体路径。前一环节正常,不代表后一环节一定正常。

发现正常却调用失败的排查链路

排查时不要先改超时、重试或负载均衡参数。先证明“注册中心给出的地址是否真的能从调用方机器访问”,这样能快速把问题分成服务端、网络和调用端三类。

核对 Nacos 返回的实例

先直接读取目标服务的实例列表,重点看 ip、port、healthy、enabled 和 weight。下面命令中的 <HOST>、<PORT> 请替换为 Nacos 地址和端口;如果部署启用了鉴权,还需要按实际环境补充认证参数。

bash
curl -s "http://<HOST>:<PORT>/nacos/v1/ns/instance/list?serviceName=order-service&groupName=DEFAULT_GROUP" \
  | jq '.hosts[] | {ip, port, healthy, enabled, weight, clusterName}'

预期输出

json
{
  "ip": "<IP>",
  "port": 8080,
  "healthy": true,
  "enabled": true,
  "weight": 1.0,
  "clusterName": "DEFAULT"
}

实际实例地址会不同。若列表为空,问题仍在服务名、Group、命名空间或注册过程;若实例存在但 healthy 为 false 或 enabled 为 false,调用端可能会过滤它,此时应先处理健康检查或实例启用状态,而不是继续排查业务接口。

从调用方机器直连实例

确认实例被发现后,必须从调用方所在机器或容器测试目标地址。只在服务端本机执行 curl localhost 没有意义,因为它绕过了真实网络路径。

bash
nc -vz <IP> <PORT>
curl -i --connect-timeout 2 "http://<IP>:<PORT>/actuator/health"

预期输出

text
Connection to <IP> <PORT> port [tcp/*] succeeded!
HTTP/1.1 200
Content-Type: application/vnd.spring-boot.actuator.v3+json

{"status":"UP"}

实际响应头和端口名称可能不同。如果 nc 失败,优先检查容器端口、宿主机映射、安全组、防火墙、Service/Ingress 转发以及注册到 Nacos 的 IP 是否可被调用方路由。如果 TCP 成功而 HTTP 返回 404、401 或 500,网络已经通了,问题应转到接口路径、鉴权或业务异常。

判断是否只在服务名调用时失败

如果直连某个实例可以成功,而通过服务名调用失败,重点检查调用端。先确认负载均衡器拿到的服务名、Group 和命名空间与刚才查询的一致,再查看是否存在多个实例,其中某一个端口错误或接口版本落后。

这类问题通常呈现为“有时成功、有时失败”。原因不是发现能力失效,而是负载均衡轮询到了异常节点。最有效的验证方法是逐个直连实例;只要某一台稳定失败,就应先摘除、禁用或修复该实例,再验证服务名调用。

如果所有实例直连都成功,但服务名调用仍失败,再检查调用框架生成的最终 URL、上下文路径、协议以及客户端过滤器。HTTP 服务被误当成 HTTPS、统一前缀 /api 未拼接、客户端额外加了鉴权头或重写路径,都可能让“地址正确”仍然得到 4xx/5xx。

按结果收敛根因

当实例列表不对时,修正注册维度;实例健康状态不对时,修正健康检查或实例状态;端口不通时,修正网络和注册地址;直连 HTTP 失败时,修正应用接口;只有在所有实例都可直连而服务名调用仍失败时,才进入负载均衡与客户端配置排查。

最终验收标准不是“控制台能看到实例”,而是从真实调用方使用服务名连续调用多次都成功,并且逐个实例也能通过同一业务路径返回预期结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查发现正常却调用失败

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通