1. 问题重现:那个让人抓狂的503
昨天本来想早点睡的,结果被一个破问题折腾到半夜,气得我差点把键盘给砸了。今天必须得把这个坑记下来,免得下次再掉进去,也希望能帮到正在坑里挣扎的你。
事情是这样的,我最近在折腾一个全新的微服务项目,技术栈选的是最新的 SpringCloud 2025.0.0 和 SpringBoot 3.5.0。网关用的是 Spring Cloud Gateway,并且为了响应式编程的潮流,网关模块引入了 spring-cloud-starter-gateway-server-webflux 和 spring-boot-starter-webflux。但是,我的后端子服务呢,还是用的传统 spring-boot-starter-web,没有升级到 WebFlux。我觉得这样搭配挺合理的,网关负责高并发和响应式,业务服务保持稳定。
配置上,我图省事,直接用了 动态路由。也就是网关从 Nacos 注册中心自动发现服务,然后根据服务名进行路由。听起来很美好对吧?结果一跑起来就傻眼了。
我用 ApiFox 或者 Postman 去请求网关的地址,比如 http://localhost:8080/api/user/1,网关的日志显示请求确实接收到了,也匹配到了路由规则。但是!响应永远是一个冷冰冰的 503 Service Unavailable。更诡异的是,我直接用 http://localhost:18081/user/1 去访问那个子服务,一切正常,接口响应飞快,日志也打得清清楚楚。
这就很奇怪了。网关能收到请求,说明网关本身是活的;子服务单独访问正常,说明子服务也是活的;Nacos 控制台里,两个服务的状态都是健康的“UP”。那问题出在哪?网关和子服务之间,仿佛隔着一道无形的墙,请求就是过不去。我在子服务的 Controller 里打了断点,发现通过网关的请求,根本进不来!这说明网关的转发在某个环节就失败了,子服务压根没收到请求。
这个 503 错误码其实很关键。在 HTTP 状态码里,5xx 是服务器端错误。503 特指“服务不可用”,对于网关来说,它通常意味着:我知道你要找谁,但我联系不上它,或者它告诉我它现在不干活。所以,排查方向就清晰了:要么是网关认为子服务不健康,拒绝转发;要么是转发过程中,寻址(找到子服务实例)的环节出了问题。
2. 排查第一步:健康检查与路由确认
遇到问题,尤其是这种“玄学”问题,最忌讳的就是瞎猜。咱们得一步步来,用证据说话。我的第一反应是:是不是网关觉得我的子服务“不健康”,所以不给它流量?
健康检查配置:在 Spring Boot 应用里,健康检查端点默认是开启的,但详细信息需要额外配置。我在子服务的 application.yml 里加上了以下配置,确保健康信息完全暴露:
management:
endpoints:
web:
exposure:
include: health,info,gateway # 开放健康、信息和网关端点
endpoint:
health:
show-details: always # 总是显示健康详情
配置完后,我直接访问子服务的健康端点:http://localhost:18081/actuator/health。返回的 JSON 清清楚楚地显示状态是 “UP”,磁盘空间、数据库连接等各项指标都正常。这说明,子服务自身的健康状况是没问题的。
网关路由信息确认:接着,我去看网关的路由信息。访问网关的 Actuator 端点:http://localhost:8080/actuator/gateway/routes。返回的列表里,我看到了我配置的动态路由规则,uri 那一栏显示的是 lb://USER-SERVICE。这个 lb:// 前缀非常关键,它告诉网关,这个地址不是一
916



被折叠的 条评论
为什么被折叠?



