httplib(Python 3 中為 http.client)是標準庫中實現 HTTP/1.1 客戶端的基礎模組,無第三方依賴、輕量級、適合簡單請求、教學或受限環境。本文系統講解核心類、常用方法、響應處理,並給出生產級封裝建議。
| 類 | 職責 |
|---|---|
HTTPConnection(host, port=80, timeout=None, ...) | 管理單個 HTTP 連接(請求/響應) |
HTTPResponse | 封裝伺服器響應,提供讀取、頭部解析、狀態碼等 |
import http.client # Python 3
# import httplib # Python 2
conn = http.client.HTTPConnection("www.python.org", timeout=10)
conn.request("GET", "/")
resp = conn.getresponse()
print(f"Status: {resp.status} {resp.reason}")
print(f"Version: HTTP/{resp.version//10}.{resp.version%10}")
print(f"Headers: {resp.getheaders()}")
body = resp.read().decode('utf-8', errors='replace')
print(body[:200])
conn.close()
HTTPConnection 關鍵方法詳解request(method, url, body=None, headers={})method:GET, POST, PUT, DELETE, HEAD, OPTIONS 等。url:請求路徑含查詢字串,如 /api/users?id=1。body:POST/PUT 發送的資料,**必須為 bytes 或 str**(自動編碼為 ISO-8859-1,建議顯式 json.dumps(...).encode())。headers:字典,自動加入 Host, Content-Length, Content-Type(若提供 body)。getresponse() → HTTPResponse必須調用一次且僅一次,返回響應對象,後續讀取 body、頭部均通過它。
set_debuglevel(level)level=1 打印原始請求/響應報文,調試神器。
HTTPResponse 核心屬性與方法| 屬性/方法 | 說明 |
|---|---|
read(amt=-1) | 讀取 body,amt 限制位元組數 |
getheader(name, default=None) | 取單個頭部,不區分大小寫 |
getheaders() | 返回 [(name, value), ...] 列表 |
status | HTTP 狀態碼(int),如 200, 404 |
reason | 狀態短語,如 "OK", "Not Found" |
version | 10=HTTP/1.0, 11=HTTP/1.1 |
msg | http.client.HTTPMessage 對象,完整頭部 |
import http.client, json
conn = http.client.HTTPSConnection("httpbin.org", timeout=5)
payload = json.dumps({"user": "demo", "action": "test"}).encode()
headers = {
"Content-Type": "application/json",
"User-Agent": "MyApp/1.0",
"Accept": "application/json"
}
conn.request("POST", "/post", body=payload, headers=headers)
resp = conn.getresponse()
print(f"{resp.status} {resp.reason}")
print(resp.getheader("Content-Type"))
data = json.loads(resp.read().decode())
print(json.dumps(data, indent=2, ensure_ascii=False))
conn.close()
HTTPConnection,減少 TCP 握手/TLS 握手開銷。長連接預設啟用(HTTP/1.1)。timeout 僅針對連接建立;讀取超時需 3.7+ HTTPConnection(..., timeout=..., source_address=...) 或自行 socket.settimeout。http.client.HTTPException, socket.timeout, ConnectionRefusedError 等。Location 重新請求,或改用 urllib.request/requests。resp.read() 返回 bytes,解碼時參考 Content-Type charset,預設 utf-8,失敗用 errors='replace'。resp.read(8192) 寫入磁碟,避免記憶體暴漲。
http.client.HTTP_PORT # 80
http.client.HTTPS_PORT # 443
http.client.responses # {200: 'OK', 404: 'Not Found', ...}
print(http.client.responses[404]) # Not Found
| 場景 | 推薦 |
|---|---|
| 零依賴、標準庫のみ、嵌入式/容器精簡鏡像 | http.client |
| 複雜認證、Session、重試、代理、多部分上傳 | requests |
| 異步高併發 | aiohttp / httpx |
| 教學/理解 HTTP 協議細節 | http.client |
http.client(舊 httplib)是 Python HTTP 客戶端的基石,掌握其連接模型、請求/響應流程、頭部處理,能在無法引入第三方庫時獨當一面,也能更深入理解上層庫的實現原理。生產環境複雜場景請優先 requests 或 httpx。