定向 HTTP 缓存控制

文中关键词 "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", 和 "OPTIONAL" 应按 BCP 14 [RFC2119] 和 [RFC8174] 的说明来解释，仅在这些词以全大写形式出现时适用。

定向字段是 Dictionary Structured Fields（RFC8941 第 3.2 节）。字典的每个成员都是一个 HTTP 缓存响应指令（见 RFC9111 第 5.2.2 节），包括扩展响应指令（见 RFC9111 第 5.2.3 节）。注意，尽管定向字段通常具有与 Cache-Control 字段相同的语法，但错误处理差异意味着使用 Cache-Control 解析器而不是 Structured Fields 解析器可能会引入互操作性问题。

由于缓存指令未以结构化数据类型定义，必须将其值映射到适当的类型。RFC9111 第 5.2 节 定义了缓存指令值可以是缺省、带引号字符串或 token。

这意味着没有值的缓存指令将映射为 Boolean（参见 RFC8941 第 3.3.6 节）。当值为带引号字符串时，映射为 String（参见 RFC8941 第 3.3.3 节）；当值为 token 时，根据内容可映射为 Token、Integer（参见 RFC8941 第 3.3.1 节）或 Decimal（参见 RFC8941 第 3.3.2 节）。

例如，max-age 指令（见 RFC9111 第 5.2.2.1 节）具有整数值；no-store（见 RFC9111 第 5.2.2.5 节）始终为 Boolean true；no-cache（见 RFC9111 第 5.2.2.4 节）的值可以是 Boolean true 或包含以逗号分隔的字段名列表的字符串。

实现 不得 生成违反这些推断约束的缓存指令值。特别地，若字符串值的首字符不是字母或 "*"，则 必须 作为 Strings 生成，以免被误判为其他类型。

实现 不应 消费违反这些推断约束的值。例如，将带小数的 max-age 强制转换为整数的消费实现，会与其他实现行为不同，可能引发互操作性问题。

在缓存指令上收到的参数应被忽略，除非另有明确规定。

如果响应中的定向字段为空，或在解析时遇到错误，则该字段 必须 被缓存忽略（即表现得好像该字段不存在，通常回退到响应中存在的其他 cache-control 机制）。

实现本规范的缓存维护一个目标列表。目标列表是一个有序的定向字段名列表，缓存使用该列表来决定缓存策略，列表顺序表示从最适用到最不适用的优先级。目标列表可以是固定的、用户可配置的，或按请求生成，取决于实现。

  [ExampleCDN-Cache-Control, CDN-Cache-Control]
  

当实现本规范的缓存收到包含其目标列表中一个或多个头字段名的响应时，缓存 必须 选择目标列表中第一个（按顺序）具有有效且非空值的字段，并使用其值来确定该响应的缓存策略；并且缓存 必须 忽略响应中的 Cache-Control 和 Expires 头字段，除非在列出的头字段中没有可用的有效非空值。

注意这是逐响应发生的；如果缓存的目标列表中没有任何成员存在、有效且非空，则缓存按照 HTTP 的要求回退到其他缓存控制机制（见 [HTTP-CACHING]）。

不在缓存目标列表内的定向字段 不得 改变该缓存的行为，且 必须 被透传。

• max-age
• must-revalidate
• no-store
• no-cache
• private

此外，它们 应 实现它们在 Cache-Control 响应头字段中支持的其他缓存指令（包括扩展缓存指令）。

定向字段中缓存指令的语义和优先级与 Cache-Control 中相同。特别地，no-store 和 no-cache 会使 max-age 无效，未识别的扩展指令将被忽略。

HTTP 缓存具有端到端的新鲜度模型，定义见 RFC9111 第 4.2 节。当某些缓存路径上的缓存只有针对它们可用的额外新鲜度机制（例如使用定向字段）时，需要谨慎考虑它们的交互。特别地，定向缓存可能具有比其他缓存更长的新鲜期，导致它向下游缓存或客户端提供的响应对其他缓存来说显得过早（甚至立即）过期，从而负面影响缓存效率。

Age: 1800
Cache-Control: max-age=600
CDN-Cache-Control: max-age=3600

从 CDN 的角度看，该响应在缓存 30 分钟后仍然是新鲜的，而从其他缓存的角度，该响应已经是陈旧的。有关更多讨论，请参见 [AGE-PENALTY]。

• 移除 Age 首部字段
• 将 Date 首部字段更新为当前时间
• 将 Expires 首部字段更新为当前时间，加上任何 Cache-Control: max-age 值

本规范对实现缓解这些影响不作具体要求，但定向字段的定义可以包含此类要求。

针对特定缓存类别的定向字段可以通过在 "Hypertext Transfer Protocol (HTTP) Field Name Registry"（<https://www.iana.org/assignments/http-fields/>）中请求注册来定义。

注册请求可以使用本文档作为规范文档；在这种情况下，Comments 字段应明确定义该定向字段适用的缓存类别。或者，如果已有其他文档定义该字段，也可使用该文档作为规范文档。

按惯例，定向字段带有后缀 "-Cache-Control"，例如 "ExampleCDN-Cache-Control"。然而，该后缀 不得 单独用来识别定向字段；它仅为一种惯例。

Cache-Control: max-age=60, s-maxage=120
CDN-Cache-Control: max-age=600

CDN-Cache-Control: max-age=600
Cache-Control: no-store

Cache-Control: no-store

Cache-Control: no-store
CDN-Cache-Control: none

（注意 'none' 不是注册的缓存指令；此处使用它是为了避免发送空值的头字段，因为空值的头字段会被忽略。）