当前位置：首页 > news >正文

Python WebSocket 实时通信实战：构建实时Web应用

news 2026/5/13 19:01:24

Python WebSocket 实时通信实战：构建实时Web应用

引言

在现代Web开发中，实时通信是构建交互式应用的关键技术。作为一名从Rust转向Python的后端开发者，我深刻体会到WebSocket在构建实时功能方面的重要性。WebSocket提供了双向通信能力，使得服务器和客户端可以实时交换数据。

WebSocket 核心概念

什么是WebSocket

WebSocket是一种在单个TCP连接上进行全双工通信的协议，具有以下特点：

双向通信：服务器和客户端可以互相发送消息
低延迟：建立连接后保持持久连接，避免HTTP请求开销
实时性：支持实时推送数据
跨域支持：支持跨域通信

架构设计

┌─────────────────────────────────────────────────────────────┐ │ WebSocket 客户端 │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ JavaScript WebSocket API │ │ │ │ 连接 → 发送消息 → 接收消息 → 断开连接 │ │ │ └─────────────────────────┬─────────────────────────┘ │ └─────────────────────────────┼─────────────────────────────┘ │ WebSocket协议 ▼ ┌─────────────────────────────────────────────────────────────┐ │ WebSocket 服务端 │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ Python WebSocket Server │ │ │ │ 接收连接 → 处理消息 → 广播消息 → 管理连接 │ │ │ └─────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘

环境搭建与基础配置

安装依赖

pip install websockets fastapi uvicorn

基本WebSocket服务器

import asyncio import websockets connected_clients = set() async def handle_client(websocket, path): connected_clients.add(websocket) print(f"Client connected. Total clients: {len(connected_clients)}") try: async for message in websocket: print(f"Received: {message}") # 广播消息给所有客户端 for client in connected_clients: if client != websocket: await client.send(message) finally: connected_clients.remove(websocket) print(f"Client disconnected. Total clients: {len(connected_clients)}") start_server = websockets.serve(handle_client, "localhost", 8765) asyncio.get_event_loop().run_until_complete(start_server) asyncio.get_event_loop().run_forever()

客户端实现

const ws = new WebSocket('ws://localhost:8765'); ws.onopen = function() { console.log('Connected to server'); ws.send('Hello, Server!'); }; ws.onmessage = function(event) { console.log('Received:', event.data); }; ws.onclose = function() { console.log('Disconnected from server'); };

FastAPI WebSocket集成

创建WebSocket端点

from fastapi import FastAPI, WebSocket, WebSocketDisconnect from typing import List app = FastAPI() class ConnectionManager: def __init__(self): self.active_connections: List[WebSocket] = [] async def connect(self, websocket: WebSocket): await websocket.accept() self.active_connections.append(websocket) def disconnect(self, websocket: WebSocket): self.active_connections.remove(websocket) async def broadcast(self, message: str): for connection in self.active_connections: await connection.send_text(message) manager = ConnectionManager() @app.websocket("/ws") async def websocket_endpoint(websocket: WebSocket): await manager.connect(websocket) try: while True: data = await websocket.receive_text() await manager.broadcast(f"Client says: {data}") except WebSocketDisconnect: manager.disconnect(websocket) await manager.broadcast("A client has disconnected")

运行服务器

uvicorn main:app --reload

高级特性实战

消息认证

from fastapi import WebSocket, Depends async def get_token(websocket: WebSocket): token = websocket.query_params.get("token") if token != "secret": await websocket.close(code=1008, reason="Invalid token") raise WebSocketDisconnect(code=1008) return token @app.websocket("/ws/auth") async def websocket_auth(websocket: WebSocket, token: str = Depends(get_token)): await websocket.accept() await websocket.send_text(f"Authenticated with token: {token}") while True: data = await websocket.receive_text() await websocket.send_text(f"Received: {data}")

分组广播

class RoomManager: def __init__(self): self.rooms: dict[str, List[WebSocket]] = {} async def join_room(self, room_id: str, websocket: WebSocket): if room_id not in self.rooms: self.rooms[room_id] = [] self.rooms[room_id].append(websocket) await websocket.accept() def leave_room(self, room_id: str, websocket: WebSocket): if room_id in self.rooms: self.rooms[room_id].remove(websocket) async def broadcast_to_room(self, room_id: str, message: str): if room_id in self.rooms: for connection in self.rooms[room_id]: await connection.send_text(message) room_manager = RoomManager() @app.websocket("/ws/room/{room_id}") async def websocket_room(websocket: WebSocket, room_id: str): await room_manager.join_room(room_id, websocket) try: while True: data = await websocket.receive_text() await room_manager.broadcast_to_room(room_id, f"Room {room_id}: {data}") except WebSocketDisconnect: room_manager.leave_room(room_id, websocket)

二进制数据传输

@app.websocket("/ws/binary") async def websocket_binary(websocket: WebSocket): await websocket.accept() while True: data = await websocket.receive_bytes() print(f"Received binary data: {len(data)} bytes") # 处理二进制数据 response = process_binary(data) await websocket.send_bytes(response)

实际业务场景

场景一：实时聊天应用

from datetime import datetime @app.websocket("/ws/chat/{username}") async def chat_endpoint(websocket: WebSocket, username: str): await manager.connect(websocket) await manager.broadcast(f"{username} joined the chat") try: while True: message = await websocket.receive_text() timestamp = datetime.now().strftime("%H:%M:%S") await manager.broadcast(f"[{timestamp}] {username}: {message}") except WebSocketDisconnect: manager.disconnect(websocket) await manager.broadcast(f"{username} left the chat")

场景二：实时数据推送

import asyncio from fastapi import BackgroundTasks async def send_realtime_data(websocket: WebSocket): while True: data = generate_realtime_data() await websocket.send_json(data) await asyncio.sleep(1) @app.websocket("/ws/realtime") async def realtime_endpoint(websocket: WebSocket): await websocket.accept() task = asyncio.create_task(send_realtime_data(websocket)) try: while True: await websocket.receive_text() except WebSocketDisconnect: task.cancel()

场景三：协作编辑

document_store = {} @app.websocket("/ws/collab/{doc_id}") async def collab_edit(websocket: WebSocket, doc_id: str): await websocket.accept() if doc_id not in document_store: document_store[doc_id] = {"content": "", "users": []} document_store[doc_id]["users"].append(websocket) try: while True: update = await websocket.receive_json() document_store[doc_id]["content"] = update["content"] for user in document_store[doc_id]["users"]: if user != websocket: await user.send_json(update) except WebSocketDisconnect: document_store[doc_id]["users"].remove(websocket)

性能优化

异步处理

async def process_message(message: str) -> str: # 异步处理消息 await asyncio.sleep(0.1) return f"Processed: {message}" @app.websocket("/ws/async") async def async_websocket(websocket: WebSocket): await websocket.accept() while True: message = await websocket.receive_text() processed = await process_message(message) await websocket.send_text(processed)

消息压缩

import gzip @app.websocket("/ws/compressed") async def compressed_websocket(websocket: WebSocket): await websocket.accept() while True: compressed_data = await websocket.receive_bytes() data = gzip.decompress(compressed_data).decode('utf-8') response = f"Received: {data}" compressed_response = gzip.compress(response.encode('utf-8')) await websocket.send_bytes(compressed_response)