Python / 系统课时

启动一个异步 TCP 服务

启动一个异步 TCP 服务

本节实现一个可直接运行的异步 TCP 服务:服务端监听本机端口,为每个连接读取一行文本并返回确认消息,再由独立客户端完成一次请求响应。完成后你会看到 StreamReader、StreamWriter 与事件循环如何协作处理连接。

学习目标

  • 使用 asyncio.start_server() 启动 TCP 监听并注册连接处理协程
  • 通过 StreamReader 和 StreamWriter 完成一次异步收发
  • 正确关闭客户端连接,并用实际请求验证服务端行为

请求响应是怎样流动的

asyncio.start_server() 接收连接后,会为每个客户端调用连接处理函数,并提供一对 reader、writer。读取操作在没有数据时会挂起当前协程,而不是阻塞整个事件循环;其他连接仍有机会继续执行。

asyncio TCP 请求响应时序

编写并启动服务端

新建 server.py。处理函数只读取一行,因此客户端要以换行符结束请求;响应同样追加换行,便于客户端用 readline() 判断一条消息结束。

python
import asyncio

HOST = "127.0.0.1"
PORT = 8888

async def handle_client(reader, writer):
    data = await reader.readline()
    message = data.decode("utf-8").rstrip("\n")
    print(f"received: {message}")

    writer.write(f"ACK: {message}\n".encode("utf-8"))
    await writer.drain()

    writer.close()
    await writer.wait_closed()
    print("connection closed")

async def main():
    server = await asyncio.start_server(handle_client, HOST, PORT)
    print(f"server listening on {HOST}:{PORT}")

    async with server:
        await server.serve_forever()

if __name__ == "__main__":
    asyncio.run(main())

预期结果:执行 python server.py 后,服务端先进入监听状态并持续运行。

text
server listening on 127.0.0.1:8888

serve_forever() 会让主协程持续等待连接;每次有客户端接入,事件循环都会调度新的 handle_client() 调用,因此单个连接在等待网络数据时不会阻塞整个服务。

用客户端完成一次请求响应

另建 client.py。客户端建立连接后发送一行文本,drain() 等待写缓冲区可继续推进,再读取服务端返回的一行响应。

python
import asyncio

HOST = "127.0.0.1"
PORT = 8888

async def main():
    reader, writer = await asyncio.open_connection(HOST, PORT)

    writer.write(b"hello asyncio\n")
    await writer.drain()

    response = await reader.readline()
    print(response.decode("utf-8").rstrip("\n"))

    writer.close()
    await writer.wait_closed()

if __name__ == "__main__":
    asyncio.run(main())

预期结果:保持服务端终端运行,再在另一个终端执行 python client.py,客户端应输出:

text
ACK: hello asyncio

与此同时,服务端终端会追加:

text
received: hello asyncio
connection closed

这说明连接建立、异步读取、响应写入和连接关闭都已经走通。若出现 ConnectionRefusedError,先确认 server.py 仍在运行,并检查客户端与服务端的 HOST、PORT 是否一致;若 8888 端口已被占用,则把两个文件中的端口一起改为同一个未占用端口后再测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

启动一个异步 TCP 服务

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

登录哪都通