HTTP 与 Web 标准 / 知识点
HTTP Header 速查手册
内容与协商
Transfer-Encoding: <coding>HTTP/1.1 中描述消息传输编码。
Transfer-Encoding
HTTP/1.1 中描述消息传输编码。
方向
请求/响应
语法
Transfer-Encoding: <coding>示例
Transfer-Encoding: chunked关键边界
HTTP/2/3 禁止使用该字段;不要和 Content-Encoding 混淆。
TE: <transfer-coding>声明客户端愿意接受的传输编码/Trailer 能力。
TE
声明客户端愿意接受的传输编码/Trailer 能力。
方向
请求
语法
TE: <transfer-coding>示例
TE: trailers关键边界
HTTP/2 中唯一允许的 TE 值是 trailers;使用场景很少。
Trailer: <field-name>, ...提前声明消息 trailer 中可能出现哪些字段。
Trailer
提前声明消息 trailer 中可能出现哪些字段。
方向
请求/响应
语法
Trailer: <field-name>, ...示例
Trailer: Digest关键边界
Trailer 位于消息末尾,不适合携带路由、认证等必须先处理的信息。
认证与会话
Authorization: <scheme> <credentials>携带访问目标资源的认证凭据。
Authorization
携带访问目标资源的认证凭据。
方向
请求
语法
Authorization: <scheme> <credentials>示例
Authorization: Bearer <TOKEN>关键边界
Bearer、Basic 等 scheme 语义不同;敏感值禁止记录到普通日志。
WWW-Authenticate: <challenge>告诉客户端可使用的认证方案及 challenge。
WWW-Authenticate
告诉客户端可使用的认证方案及 challenge。
方向
响应
语法
WWW-Authenticate: <challenge>示例
WWW-Authenticate: Bearer realm="api"关键边界
401 响应常见;可存在多个 challenge。
Proxy-Authorization: <scheme> <credentials>向 HTTP 代理提供认证凭据。
Proxy-Authorization
向 HTTP 代理提供认证凭据。
方向
请求
语法
Proxy-Authorization: <scheme> <credentials>示例
Proxy-Authorization: Basic <CREDENTIALS>关键边界
这是代理认证,不是目标站点 Authorization。
Proxy-Authenticate: <challenge>由代理声明可接受的认证方式。
Proxy-Authenticate
由代理声明可接受的认证方式。
方向
响应
语法
Proxy-Authenticate: <challenge>示例
Proxy-Authenticate: Basic realm="proxy"关键边界
常配合 407 Proxy Authentication Required。
Cookie: <name>=<value>; ...把浏览器/客户端已有 Cookie 发给服务端。
Cookie
把浏览器/客户端已有 Cookie 发给服务端。
方向
请求
语法
Cookie: <name>=<value>; ...示例
Cookie: session=<SESSION_ID>; theme=dark关键边界
Session Cookie 可能等同登录凭据;不要写进普通日志。
Set-Cookie: <name>=<value>; <attributes>让用户代理创建、更新或删除 Cookie。
Set-Cookie
让用户代理创建、更新或删除 Cookie。
方向
响应
语法
Set-Cookie: <name>=<value>; <attributes>示例
Set-Cookie: session=<ID>; Secure; HttpOnly; SameSite=Lax; Path=/关键边界
每个 Cookie 通常单独一个 Set-Cookie 字段;关注 Secure、HttpOnly、SameSite。
缓存与条件请求
Cache-Control: <directive>[, ...]控制浏览器和共享缓存的缓存行为。
Cache-Control
控制浏览器和共享缓存的缓存行为。
方向
请求/响应
语法
Cache-Control: <directive>[, ...]示例
Cache-Control: public, max-age=3600关键边界
no-cache 表示使用前需重新验证,不等于“不存储”;完全不存储用 no-store。
Expires: <HTTP-date>指定响应过期时间。
Expires
指定响应过期时间。
方向
响应
语法
Expires: <HTTP-date>示例
Expires: Wed, 26 Aug 2026 10:00:00 GMT关键边界
现代缓存优先使用 Cache-Control;max-age 通常优先级更高。
Age: <seconds>表示响应在缓存中已经存放的大致秒数。
Age
表示响应在缓存中已经存放的大致秒数。
方向
响应
语法
Age: <seconds>示例
Age: 120关键边界
通常由共享缓存/CDN 添加,不代表源服务器处理耗时。
ETag: <entity-tag>为 representation 提供实体标签,用于缓存验证和并发控制。
ETag
为 representation 提供实体标签,用于缓存验证和并发控制。
方向
响应
语法
ETag: <entity-tag>示例
ETag: "abc123"关键边界
强 ETag 和弱 ETag W/ 语义不同。
Last-Modified: <HTTP-date>告诉客户端资源最后修改时间。
Last-Modified
告诉客户端资源最后修改时间。
方向
响应
语法
Last-Modified: <HTTP-date>示例
Last-Modified: Tue, 25 Aug 2026 12:00:00 GMT关键边界
精度通常低于 ETag;缓存验证常优先 ETag。
If-None-Match: <etag>|*只有当前 representation 不匹配给定 ETag 时才继续正常处理。
If-None-Match
只有当前 representation 不匹配给定 ETag 时才继续正常处理。
方向
请求
语法
If-None-Match: <etag>|*示例
If-None-Match: "abc123"关键边界
GET/HEAD 缓存验证常返回 304;写操作中也可用 * 防止覆盖已有资源。
If-Match: <etag>|*只有当前资源匹配给定 ETag 时才执行请求。
If-Match
只有当前资源匹配给定 ETag 时才执行请求。
方向
请求
语法
If-Match: <etag>|*示例
If-Match: "abc123"关键边界
常用于乐观锁,防止并发更新覆盖。
If-Modified-Since: <HTTP-date>仅在资源自指定时间后有修改时返回完整内容。
If-Modified-Since
仅在资源自指定时间后有修改时返回完整内容。
方向
请求
语法
If-Modified-Since: <HTTP-date>示例
If-Modified-Since: Tue, 25 Aug 2026 12:00:00 GMT关键边界
若同时有 If-None-Match,通常 ETag 验证更优先。
If-Unmodified-Since: <HTTP-date>只有资源自指定时间后未修改才执行。
If-Unmodified-Since
只有资源自指定时间后未修改才执行。
方向
请求
语法
If-Unmodified-Since: <HTTP-date>示例
If-Unmodified-Since: Tue, 25 Aug 2026 12:00:00 GMT关键边界
用于避免覆盖别人刚修改的资源;ETag/If-Match 通常更精确。
Vary: <field-name>, ...告诉缓存响应内容会随哪些请求 Header 改变。
Vary
告诉缓存响应内容会随哪些请求 Header 改变。
方向
响应
语法
Vary: <field-name>, ...示例
Vary: Accept-Encoding, Accept-Language关键边界
错误使用 Vary: * 会显著降低缓存复用。
Pragma: no-cacheHTTP/1.0 时代的兼容缓存控制字段。
Pragma
HTTP/1.0 时代的兼容缓存控制字段。
方向
请求/响应
语法
Pragma: no-cache示例
Pragma: no-cache关键边界
现代 HTTP 优先 Cache-Control;仅为遗留兼容保留。