Python WebSockets 库从基础到实战使用举例

更新时间：2025年08月18日 16:05:13 作者：萧鼎

WebSocket是一种全双工、持久化的网络通信协议,适用于需要低延迟的应用,如实时聊天、股票行情推送、在线协作、多人游戏等,本文给大家介绍Python WebSockets库从基础到实战使用举例,感兴趣的朋友一起看看吧

1. 引言

WebSocket 是一种全双工、持久化的网络通信协议，适用于需要低延迟的应用，如实时聊天、股票行情推送、在线协作、多人游戏等。相比传统的 HTTP 轮询方式，WebSocket 减少了带宽开销，提高了实时性。

在 Python 中，最流行的 WebSocket 库是 websockets，它是一个基于 asyncio 的轻量级 WebSocket 库，支持 WebSocket 服务器和客户端实现。本文将深入介绍 WebSockets 及其在 Python 中的使用方法。

2. 为什么使用 WebSocket？

在传统的 HTTP 轮询（Polling）或长轮询（Long Polling）中，客户端需要不断向服务器发送请求，即使没有数据更新，也会浪费带宽和资源。WebSocket 通过单次握手建立持久连接，服务器可以主动推送数据，极大地提高了通信效率。

WebSocket 的优势：

低延迟：基于 TCP 连接，减少握手和数据传输时间。
双向通信：服务器可以主动向客户端推送消息，而无需等待请求。
减少带宽消耗：避免 HTTP 头部的额外开销，提高吞吐量。
适用于实时应用：如聊天、直播、股票行情等。

3. 安装 WebSockets 库

首先，我们需要安装 websockets：

pip install websockets

websockets 依赖 Python 3.6 及以上版本，并且基于 asyncio，所以所有 WebSocket 代码都是**异步（async）**的。

4. 使用 WebSockets 搭建 WebSocket 服务器

WebSocket 服务器的基本实现只需几行代码。

4.1 WebSocket 服务器示例

import asyncio
import websockets
async def echo(websocket, path):
    async for message in websocket:
        print(f"收到消息: {message}")
        await websocket.send(f"服务器响应: {message}")
# 启动 WebSocket 服务器
start_server = websockets.serve(echo, "0.0.0.0", 8765)
asyncio.get_event_loop().run_until_complete(start_server)
asyncio.get_event_loop().run_forever()

说明：

websockets.serve(echo, "0.0.0.0", 8765) 启动一个 WebSocket 服务器，监听 8765 端口。
async for message in websocket 监听客户端发送的消息，并在收到后回显给客户端。

5. WebSocket 客户端

WebSocket 客户端的实现也非常简单：

import asyncio
import websockets
async def client():
    async with websockets.connect("ws://localhost:8765") as websocket:
        await websocket.send("Hello, WebSocket Server")
        response = await websocket.recv()
        print(f"服务器响应: {response}")
asyncio.run(client())

说明：

websockets.connect("ws://localhost:8765") 连接 WebSocket 服务器。
await websocket.send("Hello, WebSocket Server") 发送数据。
await websocket.recv() 接收服务器的消息。

6. 处理多个客户端

通常，我们需要处理多个客户端同时连接。在 WebSockets 中，可以使用 asyncio.gather() 来管理多个 WebSocket 连接。

6.1 广播消息给所有连接的客户端

import asyncio
import websockets
connected_clients = set()  # 记录已连接的客户端
async def handler(websocket, path):
    connected_clients.add(websocket)
    try:
        async for message in websocket:
            print(f"收到消息: {message}")
            # 广播给所有客户端
            await asyncio.gather(*(client.send(f"广播消息: {message}") for client in connected_clients))
    finally:
        connected_clients.remove(websocket)
start_server = websockets.serve(handler, "0.0.0.0", 8765)
asyncio.get_event_loop().run_until_complete(start_server)
asyncio.get_event_loop().run_forever()

说明：

使用 connected_clients 集合存储所有连接的客户端。
在 async for message in websocket 内部，遍历 connected_clients，将消息发送给所有客户端。

7. WebSocket 服务器的异常处理

实际应用中，客户端可能会断开连接，或者发送非法数据。我们需要在服务器端增加异常处理，以确保服务不会崩溃。

import asyncio
import websockets
async def handler(websocket, path):
    try:
        async for message in websocket:
            print(f"收到: {message}")
            await websocket.send(f"服务器回复: {message}")
    except websockets.exceptions.ConnectionClosedError:
        print("客户端连接关闭")
    except Exception as e:
        print(f"发生错误: {e}")
start_server = websockets.serve(handler, "0.0.0.0", 8765)
asyncio.get_event_loop().run_until_complete(start_server)
asyncio.get_event_loop().run_forever()

8. 使用 WebSockets 传输 JSON 数据

在 WebSockets 通信中，通常需要传输结构化数据，例如 JSON。

服务器端：

import asyncio
import websockets
import json
async def handler(websocket, path):
    async for message in websocket:
        data = json.loads(message)
        response = {"message": f"收到: {data['content']}"}
        await websocket.send(json.dumps(response))
start_server = websockets.serve(handler, "0.0.0.0", 8765)
asyncio.get_event_loop().run_until_complete(start_server)
asyncio.get_event_loop().run_forever()

客户端：

import asyncio
import websockets
import json
async def client():
    async with websockets.connect("ws://localhost:8765") as websocket:
        data = json.dumps({"content": "Hello, Server"})
        await websocket.send(data)
        response = await websocket.recv()
        print(f"服务器响应: {json.loads(response)}")
asyncio.run(client())

9. WebSockets vs. HTTP

特性	WebSockets	HTTP
连接方式	持久连接	请求-响应
数据推送	服务器主动推送	需要轮询
适用场景	实时应用（聊天、直播）	普通 Web API

10. WebSocket 实战：实时聊天室

import asyncio
import websockets
clients = set()
async def chat(websocket, path):
    clients.add(websocket)
    try:
        async for message in websocket:
            await asyncio.gather(*(client.send(message) for client in clients))
    finally:
        clients.remove(websocket)
start_server = websockets.serve(chat, "0.0.0.0", 8765)
asyncio.get_event_loop().run_until_complete(start_server)
asyncio.get_event_loop().run_forever()

客户端可以连接服务器并发送消息，服务器会广播给所有连接的用户，形成一个实时聊天室。

总结

WebSocket 提供了低延迟、全双工通信，适用于实时应用。
websockets 库基于 asyncio，支持高并发通信。
WebSockets 可用于聊天系统、股票行情推送、多人协作、远程控制等应用场景。

通过本教程，你应该掌握了 Python websockets 库的使用方法，并能在项目中实现高效的实时通信！🚀

您可能感兴趣的文章:

Python编程之字符串模板(Template)用法实例分析
这篇文章主要介绍了Python编程之字符串模板(Template)用法,结合具体实例形式分析了Python字符串模板的功能、定义与使用方法,需要的朋友可以参考下
2017-07-07
Python+PyQt5编写图片格式转换器
这篇文章主要为大家详细介绍了如何利用Python和PyQt5编写一个简单的图片格式转换器，文中的示例代码讲解详细，感兴趣的小伙伴可以动手尝试一下
2023-07-07
web.py 十分钟创建简易博客实现代码
web.py是一款轻量级的Python web开发框架，简单、高效、学习成本低，特别适合作为python web开发的入门框架
2016-04-04
python爬虫 urllib模块发起post请求过程解析
这篇文章主要介绍了python爬虫 urllib模块发起post请求过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-08-08
Tkinter组件Entry的具体使用
本文主要介绍了Tkinter组件Entry的具体使用，Entry组件通常用于获取用户的输入文本，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-01-01
python实现桌面气泡提示功能
这篇文章主要为大家详细介绍了python实现桌面气泡提示功能，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2019-07-07
Python中的切片函数Slice详解
这篇文章主要介绍了Python中的切片函数Slice详解,切片是对有序的集合而言,意思从有序集合里提取数据构成子集集合,给定提取的起点start、终点end以及方向上的步长step,能否切出非空子集,起点start需能沿步长方向上到达终点,需要的朋友可以参考下
2023-09-09
keras获得model中某一层的某一个Tensor的输出维度教程
今天小编就为大家分享一篇keras获得model中某一层的某一个Tensor的输出维度教程，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-01-01
Python编程把二叉树打印成多行代码
这篇文章主要介绍了Python编程把二叉树打印成多行代码，具有一定借鉴价值,需要的朋友可以参考下
2018-01-01
Python中的两个列表数值加法
这篇文章主要介绍了Python中的两个列表数值加法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-08-08