Skip to content

同一个 Header 键的多个值应该如何按照规范处理?

标签
网络/协议/HTTP
网络/协议/HTTP/Header
字数
713 字
阅读时间
3 分钟
文档版本
编辑者版本变更日期变更说明
Nekov1.0.02022-05-30创建

曾经想过这个问题,但是似乎自己没有遇到过类似的情况所以没深究,今天在 Mi Home 群和 Rikumi 讨论「同一个 Header 键的多个值应该如何发送和接收」的时候好奇就去查了一下。

是在这篇文章看到讲解:Are Duplicate HTTP Response Headers acceptable? (重复的 HTTP 响应标头值应该是可被接受的吗?) - Stack Overflow 讲解中提到了一个案例 RFC2616 Header Field Definitions (标头字段定义),在这篇 RFC 针对 Cache-Control 相关的标头定义中提到了类似的「层级」:

顺藤摸瓜找到 RFC2616 的第二部分:Notational Conventions and Generic Grammar (符号约定和通用语法) 可以看到对上面提到的 1#cache-directive 层级的说明。

根据 RFC2616 第二部分的定义,任何 # 字符开头的字段结构都应该是一个列表,「每一个元素之间应该使用一个或是多个英文逗号 ,可选的线性空格(LWS)进行连接」。

我们可以因此解读以下报文:

Cache-Control: no-cache
Cache-Control: no-store

为下面的形式:

Cache-Control: no-cache, no-store

再根据 RFC7230 Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing (超文本传输协议 (HTTP/1.1): 消息语法和路由)3.2.2. Field Order 字段顺序) 章节更详细的定义:

A recipient MAY combine multiple header fields with the same field name into one "field-name: field-value" pair, without changing the semantics of the message, by appending each subsequent field value to the combined field value in order, separated by a comma. The order in which header fields with the same field name are received is therefore significant to the interpretation of the combined field value; a proxy MUST NOT change the order of these field values when forwarding a message.

翻译过来的话就是说:收件方可以将具有相同字段名的多个标头字段合并为一个 "field-name: field-value" 对,而不改变信息的语义。这个方法是将每个随后的标头字段值依次附加到后面的字段值依次追加到合并的字段值中,用逗号隔开。顺序是接收具有相同字段名的标题字段的顺序。因此,接收具有相同字段名的头字段的顺序对解释组合字段值很重要。代理在转发消息时不得改变这些字段值的顺序。转发消息时,代理不得改变这些字段值的顺序。

所以正确的做法是 对同一个 Header 键的多个值使用英文逗号进行间隔并按照传输顺序拼接在一起

贡献者

页面历史

撰写

布局切换

调整 VitePress 的布局样式,以适配不同的阅读习惯和屏幕环境。

全部展开
使侧边栏和内容区域占据整个屏幕的全部宽度。
全部展开,但侧边栏宽度可调
侧边栏宽度可调,但内容区域宽度不变,调整后的侧边栏将可以占据整个屏幕的最大宽度。
全部展开,且侧边栏和内容区域宽度均可调
侧边栏宽度可调,但内容区域宽度不变,调整后的侧边栏将可以占据整个屏幕的最大宽度。
原始宽度
原始的 VitePress 默认布局宽度

页面最大宽度

调整 VitePress 布局中页面的宽度,以适配不同的阅读习惯和屏幕环境。

调整页面最大宽度
一个可调整的滑块,用于选择和自定义页面最大宽度。

内容最大宽度

调整 VitePress 布局中内容区域的宽度,以适配不同的阅读习惯和屏幕环境。

调整内容最大宽度
一个可调整的滑块,用于选择和自定义内容最大宽度。

聚光灯

支持在正文中高亮当前鼠标悬停的行和元素,以优化阅读和专注困难的用户的阅读体验。

ON开启
开启聚光灯。
OFF关闭
关闭聚光灯。

聚光灯样式

调整聚光灯的样式。

置于底部
在当前鼠标悬停的元素下方添加一个纯色背景以突出显示当前鼠标悬停的位置。
置于侧边
在当前鼠标悬停的元素旁边添加一条固定的纯色线以突出显示当前鼠标悬停的位置。