HTTP 504 — Gateway Timeout

服务器作为网关，无法及时获得响应。

为何出现

  • 后端临时不可用或维护中。
  • 应用程序抛出未处理的异常。
  • 上游依赖（数据库、缓存、API）不可用。

如何修复

  • 检查应用日志和错误追踪以定位异常。
  • 检查依赖（数据库、缓存、上游 API）的健康状况。
  • 在事故期间采用优雅降级并实施重试。

HTTP 504（Gateway Timeout）属于服务器类代码。以下为「server」场景的背景与建议。

服务器错误反映后端问题：宕机、未处理异常或依赖不可用。此页面返回真实的 HTTP 状态，使外部系统可以正确地观察并告警 5xx。

实施带退避的重试、接入错误追踪并关注上游健康。在测试与文档中使用本页面。

关键词: HTTP 504, Gateway Timeout, HTTP error 504, status code 504, HTTP 504 meaning, fix HTTP 504, server error.