Python http.client 读取响应后为何必须关闭连接

用 Python 的 http.client 调接口时，最容易被忽略的不是发送请求，而是响应什么时候真正结束。getresponse() 返回的是一个仍然关联底层 socket 的 HTTPResponse；如果只读取了头部或一小段 body，就立刻复用同一个 HTTPConnection，下一次请求可能遇到协议错位、等待或连接被迫重建。

官方地址：https://docs.python.org/3/library/http.client.html

先分清 HTTPResponse 与 HTTPConnection 的关闭责任

HTTPConnection 表示客户端到主机的连接，而 HTTPResponse 表示这一次请求得到的响应流。调用 getresponse() 只拿到响应对象，并不代表网络上的 body 已经消费完。read() 不带参数会继续读取到响应结束；带参数则只取指定数量的字节，剩余内容仍留在流中。

因此，“读取后必须关闭”更准确的说法是：要么把当前响应体完整读完，让连接具备复用条件；要么在放弃剩余内容时关闭响应。若整个连接不再使用，再调用 conn.close() 释放连接对象。

用完整读取或 with 语句结束响应生命周期

普通的小响应可以直接完整读取。下面的模板把状态判断、读取和连接关闭放在同一个生命周期内；代码中的中文注释说明了为什么不能只看 status 就离开。

import http.client

conn = http.client.HTTPSConnection("example.com", timeout=10)
try:
    conn.request("GET", "/health")
    response = conn.getresponse()
    # 先读取完整响应，避免未消费的 body 留在连接上
    body = response.read()
    if response.status != 200:
        raise RuntimeError(f"HTTP {response.status}: {body[:120]!r}")
finally:
    # 无论读取或状态判断是否抛错，都关闭不再复用的连接
    conn.close()

如果只想放弃一个大响应的剩余数据，可以把关闭动作绑定在响应对象上。HTTPResponse 支持 with，适合把“响应结束”表达得更清楚：

conn = http.client.HTTPSConnection("example.com", timeout=10)
try:
    conn.request("GET", "/large-file")
    with conn.getresponse() as response:
        # 只取头部用于判断，离开 with 时会关闭响应流
        preview = response.read(256)
finally:
    # 本次连接不再复用，所以最终关闭连接
    conn.close()

处理部分读取、异常和连接复用边界

部分读取并不等于错误，关键是后续动作必须明确。若连接准备复用，优先把剩余 body 读完；若业务已经决定放弃，立即关闭响应，不要把“稍后由垃圾回收处理”当作资源管理策略。Python 文档还特别提示：当 getresponse() 发生非 ConnectionError 异常时，在发送下一次请求前，应读完整响应或调用 close()。

对需要持续复用的连接，可把每次响应都包进 try/finally，并区分“响应关闭”和“连接关闭”。下面是分块读取的安全形态：

conn = http.client.HTTPConnection("example.com", timeout=10)
try:
    conn.request("GET", "/events")
    response = conn.getresponse()
    try:
        while True:
            # 分块读取降低内存峰值；空字节表示响应体已结束
            chunk = response.read(8192)
            if not chunk:
                break
            consume(chunk)
    finally:
        # consume 抛错时也要结束当前响应
        response.close()
finally:
    # 只有确认不再发送请求时才关闭整条连接
    conn.close()

用检查清单验证关闭动作是否生效

排查时可以先记录 response.closed，再记录读取字节数和下一次请求是否成功。注意，closed=True 只能说明响应流已关闭，不能替代对业务状态码、body 内容和连接复用结果的判断。

相关问题

只调用 conn.close() 还需要 response.close() 吗？

如果连接确定不再使用，关闭连接通常能结束底层资源；但在复杂异常路径中显式关闭当前响应更清晰，也能准确表达响应流已经放弃。

response.read() 读到空字节说明什么？

对当前响应来说，空字节通常表示 body 已经到达结束；它不是 HTTP 状态码，也不能单独证明请求成功。

为什么不建议依赖垃圾回收自动释放？

垃圾回收时机不等于请求生命周期，连接池或高并发场景会先积累未释放的 socket。把读取和关闭写在明确的控制流中更可靠。