Python / 系统课时

read 和 write 怎样配合

read 和 write 怎样配合

在 asyncio 的流式 TCP API 中,读取由 StreamReader 消费接收缓冲区,写入由 StreamWriter 提交到发送缓冲区。掌握“读一次就消费一次、写入后用 drain() 处理背压、关闭时等待完成”这条主线,就能避免重复读取、丢响应和连接未完整关闭等常见问题。

学习目标

  • 掌握 StreamReader 与 StreamWriter 的基本配合顺序。
  • 理解 write()、drain()、readline() 与 readexactly() 的边界。
  • 能正确关闭 TCP 连接,并验证一次完整请求响应。

一次请求响应的正确顺序

服务端拿到 (reader, writer) 后,通常先从 reader 读取请求,再调用 writer.write() 写入响应。write() 会把数据交给传输层缓冲区,但它不是“数据已经发到对端”的确认;当发送速度可能超过网络或对端消费速度时,应 await writer.drain() 让协程在高水位时等待。

读取同样是有状态的。read()、readline() 或 readexactly() 返回的数据会从 StreamReader 缓冲区中被消费;再次调用读取方法时,读到的是后续数据,而不是上一份数据的副本。

用完整示例跑通读写

下面的脚本在同一个事件循环里启动本地服务器和客户端。客户端发送一行 ping,服务端读取后回复 PONG,双方都使用 drain(),最后显式关闭连接。

python
import asyncio

async def handle_client(reader: asyncio.StreamReader, writer: asyncio.StreamWriter) -> None:
    # readline 会消费到换行符为止的这一段数据。
    data = await reader.readline()
    message = data.decode().rstrip()
    print(f'server received: {message}')

    writer.write(b'PONG\n')
    # drain 在写缓冲达到高水位时提供背压。
    await writer.drain()

    writer.close()
    await writer.wait_closed()

async def main() -> None:
    server = await asyncio.start_server(handle_client, '127.0.0.1', 0)
    port = server.sockets[0].getsockname()[1]
    print('server listening on <PORT>')

    async with server:
        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().rstrip()}')

        writer.close()
        await writer.wait_closed()

asyncio.run(main())

预期输出

text
server listening on <PORT>
server received: ping
client received: PONG

<PORT> 代表操作系统自动分配的实际端口,每次运行可能不同。这个例子中,换行符同时承担了简单消息分隔符的作用,所以双方都用 readline()。

选择正确的读取方法

read(n) 最多返回 n 个字节,可能更少,适合“有多少先处理多少”的流式消费。若协议头明确规定“接下来必须读取 4 字节长度字段”,应使用 readexactly(4);若连接提前结束,它会抛出 asyncio.IncompleteReadError,比手工循环更清晰。

readline() 适合以换行结束的文本协议,但它会一直等待分隔符、EOF 或内部限制触发。不要把“调用一次 read()”误认为“读取一条消息”,因为 TCP 本身只提供字节流。

容易写错的三个位置

第一,连续两次读取不会得到同一份数据。若第一次 await reader.readline() 已经取走请求,第二次调用只会等待下一行。需要重复使用内容时,应把第一次读取结果保存在变量中。

第二,drain() 不是强制每次小写入都立刻发一个 TCP 包,它解决的是应用层写入速度与底层发送能力之间的背压问题。高并发服务如果只不断 write() 而从不等待 drain(),单个慢客户端可能让待发送数据持续堆积。

第三,关闭写端后应 await writer.wait_closed()。这样可以等待底层传输真正完成关闭流程,尤其在测试、短连接和程序即将退出时,更不容易留下未完成的连接清理。

当协议需要精确边界时,先用 readexactly() 或分隔符协议明确“这一条数据到哪里结束”,再组织 write() 与 drain();不要依赖一次读写调用天然一一对应。

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

目录与阅读设置

阅读设置

17

记录一个想法

read 和 write 怎样配合

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

登录哪都通