萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

HTTP 協議中 Content-Length 與 Transfer-Encoding 交互規則深度解析

核心定義

  • entity-length:訊息實體在**未經傳輸編碼前**的長度(如原始檔案大小)。
  • transfer-length:經過傳輸編碼 (gzip、chunked 等) **實際在網路上傳輸的位元組數**。
  • Content-Length:標頭欄位值**必須等於 transfer-length**。

HTTP 訊息長度確定規則 (RFC 7230 Section 3.3)

接收端依優先順序判斷訊息長度:

  1. 無實體回應:1xx、204 No Content、304 Not Modified、HEAD 請求回應 → **直接忽略實體**,無長度概念。
  2. Transfer-Encoding 存在 (如 chunked) → **優先使用 TE 解碼機制確定長度**,**必須忽略 Content-Length** (若同時存在)。
  3. Content-Length 存在且無 TE → 以其值為傳輸長度。**值必須與實際傳輸位元組數完全一致**。
  4. multipart/byteranges** 類型 → 以邊界分隔符確定長度。
  5. 連線關閉斷定長度:HTTP/1.0 無 Keep-Alive、或 HTTP/1.1 關閉連線 → 由伺服器關閉連線標示結束。**請求端不可用關閉連線指示請求結束** (否則伺服器無法回應)。

關鍵規則總結

場景Content-LengthTransfer-Encoding長度確定方式
固定長度、無壓縮、HTTP/1.1 Keep-Alive**必須有**,值 = 實體長度 = 傳輸長度無Content-Length
gzip/deflate 壓縮**必須有**,值 = **壓縮後**長度無 (Content-Encoding: gzip)Content-Length
Chunked 編碼**禁止出現**chunkedChunk 解析 (0 長度 chunk 結束)
HTTP/1.0 或 Connection: close可有可無無連線關閉
1xx/204/304/HEAD忽略忽略無實體

常見誤區與陷阱

誤區 1:Content-Length 代表原始內容長度

**錯誤**。若啟用 Content-Encoding: gzip,Content-Length 必須是**壓縮後**的位元組數。接收端先按 Content-Length 讀取完整壓縮資料流,再解壓縮。

誤區 2:同時發送 Content-Length 和 Transfer-Encoding: chunked

**違反協議**。RFC 7230 明確要求:If a message is received with both a Transfer-Encoding and a Content-Length header field, the Transfer-Encoding overrides the Content-Length. 但發送端**不應同時發送**,中介設備 (Proxy/WAF) 可能直接拒絕或行為未定義。

誤區 3:Chunked 只用於不知道長度時

**不完全**。Chunked 亦用於**邊生成邊傳輸** (流式響應)、**避免緩衝大量資料**、或**傳輸編碼層面的分塊**。即使知道總長度,也可選用 Chunked。

協議版本差異

版本Keep-AliveContent-Length 必要性Chunked 支援
HTTP/1.0預設關閉 (需 Connection: keep-alive)可有可無 (無則靠關閉連線)不支援 (伺服器不解析)
HTTP/1.1預設開啟**Keep-Alive 時必須有 CL 或 TE:chunked****必須支援**

實戰驗證與除錯

curl 查看原始回應

curl -v https://example.com/ 2>&1 | grep -i -E 'content-length|transfer-encoding|content-encoding'

Python 請求庫行為

import requests
r = requests.get('https://httpbin.org/stream/5', stream=True)
print(r.headers.get('Transfer-Encoding'))  # chunked
print(r.headers.get('Content-Length'))     # None
# iter_content() 自動處理 chunk 解碼

Nginx 相關配置

# 靜態檔案自動發送 Content-Length
# 動態代理 (proxy_pass) 預設啟用 chunked (HTTP/1.1 後端)
# 強制發送 Content-Length (緩衝完整回應後)
proxy_buffering on;
proxy_buffers 8 16k;
# 禁用 chunked (HTTP/1.0 後端)
proxy_http_version 1.0;
proxy_set_header Connection "";

總結

  1. Content-Length = 傳輸長度 (經過 Content-Encoding 壓縮後),必須精確匹配。
  2. Transfer-Encoding: chunked 與 Content-Length 互斥,優先使用 TE。
  3. HTTP/1.1 Keep-Alive 連線必須有明確長度指示 (CL 或 chunked),否則無法區分訊息邊界。
  4. 短連線 (Connection: close) 可靠連線關閉斷定長度,但無法支援管線化與連線複用。
  5. 開發中**優先使用成熟 HTTP 庫/框架自動處理**,手動構建原始 HTTP 訊息極易出錯。
copyright © 萬盛學電腦網 all rights reserved