Warning 是一个通用消息首部，包含有当前消息状态可能存在的问题。在响应中可以出现多个 Warning 首部。
一般来说， Warning 首部可以应用于任何类型的消息。然而一部分警告码（warn-code）是为缓存代理服务器定制的，并且只可以应用在响应消息中。
| Header type | General header |
|---|---|
| Forbidden header name | no |
语法
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 | Response is Stale | 由缓存服务器提供的响应已过期（设置的失效时间已过）。 |
| 111 | Revalidation Failed | 由于无法访问服务器，响应验证失败。 |
| 112 | Disconnected Operation | 缓存服务器断开连接。 |
| 113 | Heuristic Expiration | 如果缓存服务器采用启发式方法，将缓存的有效时间设定为24小时，而在该响应的年龄超过24小时时发送。 |
| 199 | Miscellaneous Warning | 任意的、未明确指定的警告信息。 |
| 214 | Transformation Applied | 由代理服务器添加，如果它对返回的展现内容进行了任何转换，比如改变了内容编码、媒体类型等。 |
| 299 | Miscellaneous Warning | 与199类似，只不过指代的是持久化警告。 |
示例
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"
规范
| Specification | Title |
|---|---|
| RFC 7234, section 5.5: Warning | Hypertext Transfer Protocol (HTTP/1.1): Caching |
浏览器兼容性
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
| Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |