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(),最后显式关闭连接。
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())预期输出
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();不要依赖一次读写调用天然一一对应。