5xx 服务端错误
504 Gateway Timeout
网关或代理没有在规定时间内收到上游服务器的响应。
应用可以连通但太慢,代理的超时时间(通常是 60 秒)先到了。
常见原因与解决方法
- 找出慢的环节:数据库查询、外部接口调用,或者耗时较长的大模型生成。
- 只有任务确实需要较长时间时,才调大代理超时(如 nginx 的
proxy_read_timeout)。 - 把长任务改为后台任务(返回 202),或使用流式响应尽早开始返回数据。
响应示例
HTTP/1.1 504 Gateway Timeout
Date: Thu, 22 Oct 2026 08:00:00 GMT 用 curl -I https://example.com 可以查看某个地址返回的状态码和响应头。