HTTP 与 Web 标准 / 系统课时
理解分块传输编码
理解分块传输编码
当 HTTP/1.1 服务端无法在发送响应头时预先知道完整响应体大小,又希望保持连接可复用时,可以用分块传输编码为消息划定边界。本篇重点读懂每个 chunk 的组织方式,并厘清它与 Content-Length 的互斥关系。
学习目标
- 读懂
Transfer-Encoding: chunked的块长度、块数据和结束块。 - 判断什么时候需要分块传输,以及它为什么有利于 HTTP/1.1 连接复用。
- 正确处理
Transfer-Encoding与Content-Length同时出现的异常报文。
为什么 HTTP/1.1 需要分块边界
HTTP/1.1 默认允许在一条 TCP 连接上连续传输多条消息。接收方因此必须知道“当前响应体在哪里结束”,否则无法判断后续字节属于本响应还是下一条响应。
如果响应体大小已经确定,服务端通常可以发送 Content-Length。但动态模板、流式生成或边计算边输出时,完整长度可能要到最后才能知道。直接靠关闭 TCP 连接表示结束虽然可行,却会失去连接复用。chunked 则把响应体拆成一个个自描述长度的块,最后用长度为零的块明确收尾。

一个 chunked 响应怎样编码
下面是一个便于手工检查的 HTTP/1.1 报文示例。线上实际传输使用 CRLF 作为行结束符;这里用普通换行展示。块长度使用十六进制,并且只计算紧随其后的数据字节数。
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Transfer-Encoding: chunked
7
Mozilla
9
Developer
7
Network
0预期结果是接收方去掉每个块的长度行和分隔符后,重建出连续响应体:
MozillaDeveloperNetwork这里 7、9、7 分别对应三段 ASCII 数据的字节数,最后的 0 表示响应体结束。若使用 trailer 字段,它们位于 0 块之后、最终空行之前;普通响应不需要 trailer。
它与 Content-Length 是两套定界方式
当完整长度已知时,同一个响应可以直接使用固定长度,而不必分块。上例的实体数据共 23 字节,因此固定长度形式可以写成:
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Length: 23
MozillaDeveloperNetwork预期结果仍然是同样的 23 字节响应体,但接收方通过 Content-Length 判断结束位置,不再解析 chunk 边界。
发送方不应在同一条消息里同时发送 Transfer-Encoding 和 Content-Length。如果服务端、代理或网关收到两者并存的报文,应把它视为异常输入:不同组件若采用不同定界规则,可能造成 HTTP 请求走私等安全问题。实际处理策略可以是直接拒绝,或在确认报文规则后移除冲突的 Content-Length 再转发,但不能让上下游各自猜测。
使用与排查边界
chunked 是 HTTP/1.1 的消息传输编码,不是内容压缩算法。它解决“怎样确定消息边界”,不会让正文自动变小;gzip、br 等 Content-Encoding 解决的才是表示数据压缩问题。
HTTP/2 和 HTTP/3 自带帧边界,不使用 HTTP/1.1 的 chunked 传输编码。因此抓包或查看网关日志时,要先确认观测的是哪一段协议:客户端到 CDN 可能是 HTTP/2,而 CDN 回源到旧服务可能被转换成 HTTP/1.1 并使用 chunked。判断问题时,把“应用是否分批产出数据”和“线上是否出现 Transfer-Encoding: chunked”分开看,才能避免把流式响应与具体协议编码混为一谈。