知识库故障排查Gateway返回503且提示无可用服务实例,如何排查?

Gateway返回503且提示无可用服务实例,如何排查?

故障排查ZVF · ZCenter适用版本5.1.0文章 IDKB-100596更新于2026-09-16

问题说明

本文用于排查Gateway本身可以访问,但访问Portal、VM或其他业务API时返回503、无可用服务实例或LoadBalancer服务发现失败的问题。该场景重点检查Nacos注册发现,不重复处理外部8100端口本身的连通性问题。

现象

  • Gateway端口可连接,但访问/portal/.../vm/...或其他业务路由返回HTTP 503。
  • 错误信息包含“No servers available”、no available service instance、LoadBalancer或服务发现超时。
  • 目标服务进程看似运行,但在Nacos中不存在、处于不健康/禁用状态,或注册IP和端口不可访问。
  • Gateway与目标服务使用不同Nacos地址、命名空间或服务名,导致目标服务对Gateway不可见。

适用环境

  • 产品:ZCenter
  • 版本:5.1.0
  • 组件:Spring Cloud Gateway、Spring Cloud LoadBalancer、Nacos及目标业务服务
  • 部署形态:单节点、多节点或容器部署

可能原因

  • Nacos不可访问、认证失败或目标服务未注册。
  • 目标业务服务未启动、处于startingexited状态,导致Nacos中没有可用实例。
  • Gateway和目标服务的Nacos地址、命名空间、分组不一致。

登录查看余下内容,以及更多产品问题排查与解决经验。

Gateway返回503且提示无可用服务实例,如何排查? | KB-100596 | ZStack 资源中心