Warning 标头

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

注意: 该标头已被弃用,因为它未被广泛生成或呈现给用户(参见 RFC9111)。某些信息可以从其他标头(例如 Age)推断出来。

HTTP Warning 请求响应标头包含有关消息状态可能出现问题的信息。一个响应中可能会出现多个 Warning 标头。

Warning 标头字段通常可以应用于任何消息。但是,某些警告代码特定于缓存,并且只能应用于响应消息。

头类型 请求标头, 响应标头
禁止请求头

语法

http
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]

指令

<warn-code>

一个三位数的警告编号。第一位指示在验证后是否需要从存储的响应中删除 Warning

  • 1xx 警告代码描述响应的新鲜度或验证状态,并在成功验证后被缓存删除。
  • 2xx 警告代码描述表示的某些方面,这些方面不会通过验证得到纠正,并且在验证后不会被缓存删除,除非发送完整响应。
<warn-agent>

添加 Warning 标头的服务器或软件的名称或别名(当代理未知时可能为 "-")。

<warn-text>

描述错误的建议文本。

<warn-date> 可选

一个日期。如果发送多个 Warning 标头,则包含一个与 Date 标头匹配的日期。

警告代码

iana.org 上的 HTTP 警告代码注册表定义了警告代码的命名空间。

代码 文本 描述
110 响应已过期 缓存提供的响应已过期(为响应设置的过期时间已过)。
111 重新验证失败 由于无法访问服务器,重新验证过期响应的尝试失败。
112 断开连接操作 缓存有意与网络的其余部分断开连接。
113 启发式过期 缓存启发式地选择了大于 24 小时的新鲜生命周期,并且响应的年龄大于 24 小时。
199 杂项警告 应呈现给用户或记录的任意信息。
214 已应用转换 如果代理对表示应用任何转换,例如更改内容编码、媒体类型等,则由代理添加。
299 杂项持久警告 应呈现给用户或记录的任意信息。此警告代码类似于警告代码 199,并额外指示一个持久警告。

示例

http
Warning: 110 anderson/1.3.37 "Response is stale"

Date: Wed, 21 Oct 2015 07:28:00 GMT
Warning: 112 - "cache down" "Wed, 21 Oct 2015 07:28:00 GMT"

规范

规范
HTTP 缓存
# field.warning

浏览器兼容性

另见