HTTP 与 Web 标准 / 系统课时

看懂 5xx 服务端错误

看懂 5xx 服务端错误

500、502、503、504 都属于服务端错误,但它们指向的故障层并不相同。排查这类问题时,关键不是反复重试,而是先确认谁生成了响应,再沿客户端、网关、应用和上游依赖的链路判断故障发生在哪一层。

学习目标

  • 区分 500、502、503、504 所表达的故障语义
  • 根据网关、应用和上游服务的角色判断错误来源
  • 使用请求 ID、耗时和日志信息建立有效的排查顺序

先确定是谁返回了错误

真实系统通常不只有客户端和应用服务器两层。一次请求可能先经过 CDN、负载均衡器或反向代理,再进入应用服务,应用还会继续访问数据库、缓存或其他 HTTP 服务。同一个用户看到的 5xx,可能由链路中的不同节点生成。

500、502、503、504 在请求链路中的故障位置

图中最重要的判断是:状态码是谁生成的。如果响应来自反向代理,那么 502 或 504 往往意味着代理与上游之间出现问题;如果应用自己返回 500,则应直接检查应用日志和异常堆栈。

四个状态码分别意味着什么

状态码 常见语义 优先检查
500 Internal Server Error 处理请求时发生未被正确处理的服务端错误 应用异常、代码错误、依赖调用失败
502 Bad Gateway 网关或代理无法从上游获得有效响应 上游进程、连接失败、协议错误、代理配置
503 Service Unavailable 服务当前暂时无法处理请求 实例可用性、过载、维护、连接池或容量
504 Gateway Timeout 网关等待上游响应超过期限 上游耗时、网络延迟、慢查询、超时配置

500 通常意味着请求已经进入负责业务处理的服务,但执行过程中发生了无法正常完成的异常。它是比较宽泛的状态码,因此必须结合异常日志才能确定真正根因。

502 和 504 都经常由网关产生,但区别在于:502 更偏向“没有拿到有效的上游响应”,504 更明确表示“已经等待上游,但等待时间超过了限制”。

503 则更强调当前服务暂时不可用。例如服务没有健康实例、系统进入维护状态或负载已经超过可处理范围,都可能使用 503。它并不自动等价于某个具体组件宕机。

用日志判断故障在哪一层

下面是一个片段示例,假设反向代理访问日志包含状态码、上游地址、上游耗时和总请求耗时;字段名称会因 Nginx、Envoy 或其他网关实现而不同:

text
<TIME> request_id=<ID> status=504 upstream=10.0.0.12:<PORT> upstream_time=30.000 request_time=30.001

预期结果:这类记录表明响应状态为 504,并且网关等待上游约 30 秒后结束请求;<TIME>、<ID>、<PORT> 和具体耗时会随环境变化。

这时第一步不应修改浏览器或客户端参数,而应检查 10.0.0.12:<PORT> 对应的上游实例在同一时间是否处理缓慢,再继续看应用日志、数据库慢查询或下游调用耗时。如果上游日志完全没有这次请求,则还需要检查网关到上游之间的连接和路由。

如果日志显示 502,而且上游连接被拒绝,优先检查目标进程是否监听正确端口、健康检查是否已经将实例摘除,以及代理配置中的上游地址是否正确。若 TCP 连接正常但响应协议损坏,再向 HTTP/TLS 协议层排查。

建立一条稳定的排查顺序

遇到 5xx 时,先记录发生时间、请求 URL、状态码、请求 ID 和总耗时,然后确认响应经过了哪些代理层。接着从产生状态码的节点向上游追踪,而不是同时翻所有机器的日志。

对于 500,通常先查应用自身同一请求 ID 对应的异常;对于 502,先验证网关能否建立到上游的连接并得到合法响应;对于 503,先看实例数量、健康检查、容量和维护状态;对于 504,则重点比较网关超时时间与应用、数据库、下游 HTTP 调用的实际耗时。

如果系统支持分布式追踪,请求 ID 或 Trace ID 可以把网关、应用和下游调用串起来。没有统一标识时,仅靠时间戳关联日志容易在高并发环境中误判请求。

从状态码走向根因

状态码只能告诉你故障的大致位置,不能直接告诉你根因。一个 504 的最终原因可能是数据库慢查询,也可能是应用线程池阻塞;一个 503 可能来自过载,也可能来自发布期间暂时没有健康实例。

因此,处理 5xx 的核心方法是先识别响应生成者,再沿请求链路查看连接状态、健康状态、处理耗时和日志证据。这样才能把“服务端错误”进一步缩小到具体组件和具体故障,而不是停留在状态码表面。

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

目录与阅读设置

阅读设置

17

记录一个想法

看懂 5xx 服务端错误

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

登录哪都通