萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python httplib 模組構建 HTTP 客戶端實戰指南

前言

httplib(Python 3 中為 http.client)是標準庫中實現 HTTP/1.1 客戶端的基礎模組,無第三方依賴、輕量級、適合簡單請求、教學或受限環境。本文系統講解核心類、常用方法、響應處理,並給出生產級封裝建議。

核心類速覽

類職責
HTTPConnection(host, port=80, timeout=None, ...)管理單個 HTTP 連接(請求/響應)
HTTPResponse封裝伺服器響應,提供讀取、頭部解析、狀態碼等

快速上手:GET 請求範例


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), ...] 列表
statusHTTP 狀態碼(int),如 200, 404
reason狀態短語,如 "OK", "Not Found"
version10=HTTP/1.0, 11=HTTP/1.1
msghttp.client.HTTPMessage 對象,完整頭部

進階示例:自定義 Headers + POST JSON


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()

常見坑點與最佳實踐

  1. 連接復用:同一 Host 多次請求可復用 HTTPConnection,減少 TCP 握手/TLS 握手開銷。長連接預設啟用(HTTP/1.1)。
  2. 超時控制:構造函數 timeout 僅針對連接建立;讀取超時需 3.7+ HTTPConnection(..., timeout=..., source_address=...) 或自行 socket.settimeout。
  3. 錯誤處理:捕獲 http.client.HTTPException, socket.timeout, ConnectionRefusedError 等。
  4. 重定向:標準庫**不自動跟隨** 301/302,需手動讀取 Location 重新請求,或改用 urllib.request/requests。
  5. 編碼:resp.read() 返回 bytes,解碼時參考 Content-Type charset,預設 utf-8,失敗用 errors='replace'。
  6. 大文件流式處理:循環 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

何時選擇 httplib vs requests

場景推薦
零依賴、標準庫のみ、嵌入式/容器精簡鏡像http.client
複雜認證、Session、重試、代理、多部分上傳requests
異步高併發aiohttp / httpx
教學/理解 HTTP 協議細節http.client

總結

http.client(舊 httplib)是 Python HTTP 客戶端的基石,掌握其連接模型、請求/響應流程、頭部處理,能在無法引入第三方庫時獨當一面,也能更深入理解上層庫的實現原理。生產環境複雜場景請優先 requests 或 httpx。

copyright © 萬盛學電腦網 all rights reserved