警告

已弃用:此功能不再推荐使用。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中移除,或者正在被移除,或者仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表格,以指导您的决策。请注意,此功能可能随时停止工作。

注意:此标头已弃用,因为它没有被广泛生成或公开给用户(请参阅RFC9111)。某些信息可以从其他标头(例如Age)推断出来。

Warning HTTP 标头包含有关消息状态可能存在的问题的信息。响应中可能出现多个 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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅