Retry-After header

HTTP Retry-After 响应头指示用户代理在进行后续请求之前应该等待多长时间。此头主要用于以下三种情况:

  • 503 Service Unavailable 响应中,这表示服务预计不可用多长时间。
  • 429 Too Many Requests 响应中,这表示在发出新请求之前需要等待多长时间。
  • 在重定向响应中,例如 301 Moved Permanently,这表示用户代理被要求在发出重定向请求之前至少等待的时间。
头类型 响应头
禁止请求头

语法

http
Retry-After: <http-date>
Retry-After: <delay-seconds>

指令

<http-date>

一个日期,在此日期之后重试。有关 HTTP 日期格式的更多详细信息,请参阅 Date 头。

<delay-seconds>

一个非负十进制整数,表示收到响应后延迟的秒数。

示例

处理计划停机

客户端和服务器对 Retry-After 头的支持仍然不一致。然而,一些爬虫和蜘蛛,如 Googlebot,会遵守 Retry-After 头。将其与 503 响应一起发送很有用,这样搜索引擎在停机结束后会继续索引您的网站。

http
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT
Retry-After: 120

规范

规范
HTTP 语义
# field.retry-after

浏览器兼容性

另见