You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

HTTP是否存在「资源尚未就绪」对应的响应状态码?

适配场景的HTTP响应码推荐

对于你描述的「请求合法有权限,但目标资源暂未就绪需稍后重试」的场景,最适配的标准HTTP响应码是 503 Service Unavailable。

为什么选503?

  • 503的标准定义就是「服务器暂时无法处理请求,可能是过载或维护,也可用于资源尚未就绪的场景」,完全匹配你的需求。
  • 可以通过Retry-After响应头附带建议等待时长,格式支持秒数(如Retry-After: 60)或HTTP日期(如Retry-After: Fri, 03 Nov 2023 12:00:00 GMT),明确告知客户端何时重试。

为什么不选其他码?

  • 425 Too Early:设计用于防止重放攻击,针对的是请求发送时机过早(如TLS握手未完成),和资源未就绪无关。
  • 404 Not Found:表示资源不存在或无法定位,无法传递「暂未就绪」的含义,客户端可能会放弃重试。
  • 412 Precondition Failed:要求请求满足特定前置条件(如If-Match),但你的场景中请求本身无问题,只是资源没准备好,不适用。

是否需要自定义响应码?

完全不需要自定义。自定义非标准响应码会导致客户端兼容性问题(很多HTTP客户端对非标准码的处理逻辑不一致),而503是所有HTTP客户端都能识别的标准码,配合Retry-After头就能完美解决你的场景需求。

内容的提问来源于stack exchange,提问作者billpg

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.06 21:14:51