Python / 系统课时

连接断开后怎么安全清理

连接断开后怎么安全清理

异步连接可能因客户端主动关闭、网络重置、任务取消或服务停机而结束。真正可靠的处理方式不是为每种异常各写一套收尾,而是让所有退出路径汇入同一个清理区,确保子任务、缓冲区和底层连接最终都被释放。

学习目标

  • 区分 EOF、连接异常与任务取消三类退出路径
  • 用 try/except/finally 建立只执行一次的统一清理边界
  • 正确关闭 StreamWriter,并回收连接关联的子任务与缓冲资源

把所有退出路径汇入 finally

reader.read() 或 readline() 返回空字节串表示对端已经正常关闭写端;ConnectionResetError、BrokenPipeError 常见于连接被异常重置;asyncio.CancelledError 则表示当前处理任务被上层取消。三者原因不同,但资源释放动作基本相同,因此清理代码应放在 finally。

取消异常需要特别处理:可以记录现场,但通常必须重新抛出,让取消语义继续向上传播。若吞掉 CancelledError,服务关闭时就可能出现任务迟迟不退出的问题。

连接退出统一清理流程

一个可运行的安全清理示例

下面的服务为每条连接创建一个心跳子任务,并维护一个连接缓冲区。无论客户端正常断开、连接异常还是处理任务被取消,finally 都会先终止子任务,再释放缓冲并关闭 StreamWriter。使用高层 Streams API 时,不要再额外直接关闭其底层 Socket。

python
import asyncio
from contextlib import suppress

async def heartbeat(writer: asyncio.StreamWriter) -> None:
    try:
        while not writer.is_closing():
            await asyncio.sleep(1)
    except asyncio.CancelledError:
        raise

async def handle_client(
    reader: asyncio.StreamReader,
    writer: asyncio.StreamWriter,
    cleaned: asyncio.Event,
) -> None:
    child = asyncio.create_task(heartbeat(writer))
    buffer = bytearray()

    try:
        data = await reader.readline()
        if not data:
            return

        buffer.extend(data)
        writer.write(buffer)
        await writer.drain()
    except (ConnectionResetError, BrokenPipeError) as exc:
        print(f"connection lost: {type(exc).__name__}")
    except asyncio.CancelledError:
        print("handler cancelled")
        raise
    finally:
        # 子任务必须先取消并等待,避免它继续使用即将关闭的连接。
        child.cancel()
        with suppress(asyncio.CancelledError):
            await child

        buffer.clear()
        writer.close()
        with suppress(ConnectionError):
            await writer.wait_closed()

        print("cleanup complete")
        cleaned.set()

async def main() -> None:
    cleaned = asyncio.Event()

    async def on_connect(
        reader: asyncio.StreamReader,
        writer: asyncio.StreamWriter,
    ) -> None:
        await handle_client(reader, writer, cleaned)

    server = await asyncio.start_server(on_connect, "127.0.0.1", 0)
    port = server.sockets[0].getsockname()[1]

    reader, writer = await asyncio.open_connection("127.0.0.1", port)
    writer.write(b"ping\n")
    await writer.drain()

    reply = await reader.readline()
    print(f"client received: {reply.decode().strip()}")

    writer.close()
    await writer.wait_closed()
    await cleaned.wait()

    server.close()
    await server.wait_closed()

asyncio.run(main())

预期输出

text
client received: ping
cleanup complete

端口由操作系统动态分配,实际值不会固定;示例不依赖具体端口。客户端关闭后,服务端读到 EOF,处理任务进入 finally,因此清理日志仍会出现。

清理顺序为什么重要

若连接处理逻辑还派生了后台任务,应先取消并等待这些任务,再关闭它们依赖的连接。否则子任务可能在 writer.close() 之后继续执行 write() 或 drain(),制造新的异常。

writer.close() 只是发起关闭;await writer.wait_closed() 才等待底层传输真正结束。对已发生连接重置的场景,等待关闭仍可能抛出 ConnectionError,因此清理阶段通常只抑制这类已经无法恢复的连接错误,而不要把所有异常都一概吞掉。

避免重复关闭和悬挂任务

资源所有权要保持单一:谁创建连接关联的子任务,谁负责取消并等待;谁持有 StreamWriter 的生命周期,谁负责最终关闭。上层服务可以取消整个连接处理任务,但不应再并行执行一套重复的连接清理逻辑。

排查“连接数下降了但任务数不降”时,优先检查是否存在未等待的子任务;排查文件描述符持续增长时,则检查每条退出路径是否都能进入 finally 并执行 wait_closed()。把所有终止路径统一到一个清理出口,才能让异常断线与服务停机使用同一套可靠机制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

连接断开后怎么安全清理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通