Python / 系统课时
连接断开后怎么安全清理
连接断开后怎么安全清理
异步连接可能因客户端主动关闭、网络重置、任务取消或服务停机而结束。真正可靠的处理方式不是为每种异常各写一套收尾,而是让所有退出路径汇入同一个清理区,确保子任务、缓冲区和底层连接最终都被释放。
学习目标
- 区分 EOF、连接异常与任务取消三类退出路径
- 用
try/except/finally建立只执行一次的统一清理边界 - 正确关闭
StreamWriter,并回收连接关联的子任务与缓冲资源
把所有退出路径汇入 finally
reader.read() 或 readline() 返回空字节串表示对端已经正常关闭写端;ConnectionResetError、BrokenPipeError 常见于连接被异常重置;asyncio.CancelledError 则表示当前处理任务被上层取消。三者原因不同,但资源释放动作基本相同,因此清理代码应放在 finally。
取消异常需要特别处理:可以记录现场,但通常必须重新抛出,让取消语义继续向上传播。若吞掉 CancelledError,服务关闭时就可能出现任务迟迟不退出的问题。

一个可运行的安全清理示例
下面的服务为每条连接创建一个心跳子任务,并维护一个连接缓冲区。无论客户端正常断开、连接异常还是处理任务被取消,finally 都会先终止子任务,再释放缓冲并关闭 StreamWriter。使用高层 Streams API 时,不要再额外直接关闭其底层 Socket。
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())预期输出
client received: ping
cleanup complete端口由操作系统动态分配,实际值不会固定;示例不依赖具体端口。客户端关闭后,服务端读到 EOF,处理任务进入 finally,因此清理日志仍会出现。
清理顺序为什么重要
若连接处理逻辑还派生了后台任务,应先取消并等待这些任务,再关闭它们依赖的连接。否则子任务可能在 writer.close() 之后继续执行 write() 或 drain(),制造新的异常。
writer.close() 只是发起关闭;await writer.wait_closed() 才等待底层传输真正结束。对已发生连接重置的场景,等待关闭仍可能抛出 ConnectionError,因此清理阶段通常只抑制这类已经无法恢复的连接错误,而不要把所有异常都一概吞掉。
避免重复关闭和悬挂任务
资源所有权要保持单一:谁创建连接关联的子任务,谁负责取消并等待;谁持有 StreamWriter 的生命周期,谁负责最终关闭。上层服务可以取消整个连接处理任务,但不应再并行执行一套重复的连接清理逻辑。
排查“连接数下降了但任务数不降”时,优先检查是否存在未等待的子任务;排查文件描述符持续增长时,则检查每条退出路径是否都能进入 finally 并执行 wait_closed()。把所有终止路径统一到一个清理出口,才能让异常断线与服务停机使用同一套可靠机制。