HTTP Header 字段完整參考手冊：25 大請求/響應頭參數詳解與實戰案例

HTTP 協議結構回顧

HTTP 報文 = Message Header（消息頭） + Message Body（消息體）。Header 先行，包含請求頭、響應頭、通用頭、實體頭四類。

核心字段分類詳解

內容協商類

Accept

客戶端可接受媒體類型，如 text/html, application/json;q=0.9

Accept-Charset

可接受字符集，如 utf-8, gbk;q=0.7

Accept-Encoding

可接受編碼/壓縮，如 gzip, deflate, br

Accept-Language

可接受語言，如 zh-CN, zh;q=0.9, en;q=0.8

範圍請求類

Accept-Ranges

服務端響應：bytes 支持斷點續傳，none 不支持

Range

客戶端請求部分內容：bytes=0-1023

Content-Range

響應實體範圍：bytes 0-1023/2048

If-Range

條件範圍：實體未變則發送範圍，否則發送整體

緩存控制類

Cache-Control

核心指令：no-cache（驗證後用）、no-store（不緩存）、max-age=秒、public/private、must-revalidate

Expires

HTTP/1.0 過期時間：Wed, 21 Oct 2025 07:28:00 GMT

ETag

實體標籤（強/弱），配合 If-None-Match 驗證

Last-Modified

最後修改時間，配合 If-Modified-Since

Age

代理緩存實體存活秒數

Vary

指導代理按何請求頭區分緩存版本，如 Accept-Encoding

連接管理類

Connection

keep-alive 持久連接，close 關閉

Keep-Alive

參數：timeout=5, max=100

Transfer-Encoding

chunked 分塊傳輸，HTTP/1.1 預設

Upgrade

協議升級（WebSocket/HTTP/2）

身份認證類

Authorization

攜帶憑證：Basic base64(user:pass)、Bearer token

WWW-Authenticate

401 響應要求認證方案

Proxy-Authenticate / Proxy-Authorization

代理認證

實體信息類

Content-Type

MIME 類型：application/json; charset=utf-8

Content-Length

實體字節長度

Content-Encoding

實體壓縮方式：gzip

Content-Language

實體語言

Content-Location

實體替代位置

其他常用

Host

請求目標主機：api.example.com:443（HTTP/1.1 必須）

User-Agent

客戶端標識

Referer

來源頁面 URL

Location

3xx 重定向目標

Server

服務端軟件：nginx/1.24.0

Pragma

no-cache 兼容 HTTP/1.0

Via

代理鏈路記錄

實戰請求/響應頭範例

# 請求頭
GET /api/users HTTP/1.1
Host: api.example.com
User-Agent: Mozilla/5.0 ...
Accept: application/json
Accept-Encoding: gzip, deflate, br
Accept-Language: zh-CN,zh;q=0.9
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
If-None-Match: "abc123"
Connection: keep-alive

# 響應頭
HTTP/1.1 200 OK
Date: Mon, 23 Dec 2024 10:00:00 GMT
Server: nginx/1.24.0
Content-Type: application/json; charset=utf-8
Content-Encoding: gzip
Content-Length: 1234
ETag: "abc123"
Cache-Control: max-age=300, must-revalidate
Vary: Accept-Encoding
Connection: keep-alive