Python / 系统课时
启动一个异步 TCP 服务
启动一个异步 TCP 服务
本节实现一个可直接运行的异步 TCP 服务:服务端监听本机端口,为每个连接读取一行文本并返回确认消息,再由独立客户端完成一次请求响应。完成后你会看到 StreamReader、StreamWriter 与事件循环如何协作处理连接。
学习目标
- 使用
asyncio.start_server()启动 TCP 监听并注册连接处理协程 - 通过
StreamReader和StreamWriter完成一次异步收发 - 正确关闭客户端连接,并用实际请求验证服务端行为
请求响应是怎样流动的
asyncio.start_server() 接收连接后,会为每个客户端调用连接处理函数,并提供一对 reader、writer。读取操作在没有数据时会挂起当前协程,而不是阻塞整个事件循环;其他连接仍有机会继续执行。

编写并启动服务端
新建 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:8888serve_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 端口已被占用,则把两个文件中的端口一起改为同一个未占用端口后再测试。
按自己的节奏,确认真正理解。