0

0

怎样用Python开发WebSocket服务?实时通信方案

爱谁谁

爱谁谁

发布时间:2025-07-17 11:36:02

|

334人浏览过

|

来源于php中文网

原创

python开发websocket服务有三种常见方案。1. 使用websockets库:轻量级适合学习,通过asyncio实现异步通信,安装简单且代码易懂,但不便集成到web框架;2. flask项目推荐flask-socketio:结合flask使用,支持rest api与websocket共存,部署需配合eventlet或gevent提升并发;3. django项目使用channels:完整支持django生态,通过asgi处理websocket请求,配置较复杂但适合大型项目。选择依据场景而定,小项目用websockets,已有flask选flask-socketio,django必用channels,并注意连接管理及性能优化。

怎样用Python开发WebSocket服务?实时通信方案

用Python开发WebSocket服务,其实不难。如果你需要做实时通信,比如聊天应用、在线协作工具或者实时数据推送,WebSocket是个很合适的选择。相比传统的HTTP轮询,它能实现双向通信,效率更高,延迟更低。

怎样用Python开发WebSocket服务?实时通信方案

Python生态中有一些现成的库可以帮你快速搭建WebSocket服务,下面我来分享几种常见方案和操作方法。

怎样用Python开发WebSocket服务?实时通信方案

1. 使用 websockets 库:轻量级纯WebSocket服务

如果你想从头开始构建一个简单的WebSocket服务,推荐使用 websockets 这个第三方库。它是基于asyncio的,适合做异步处理。

立即学习Python免费学习笔记(深入)”;

安装方式很简单:

怎样用Python开发WebSocket服务?实时通信方案
pip install websockets

写一个基础的服务端示例:

import asyncio
import websockets

async def echo(websocket, path):
    async for message in websocket:
        print(f"收到消息: {message}")
        await websocket.send(f"服务器回复: {message}")

start_server = websockets.serve(echo, "localhost", 8765)

asyncio.get_event_loop().run_until_complete(start_server)
asyncio.get_event_loop().run_forever()

这个例子会启动一个监听在 ws://localhost:8765 的WebSocket服务,接收客户端消息并原样返回。

客户端可以用浏览器测试,也可以用另一个Python脚本连接:

async def connect():
    async with websockets.connect("ws://localhost:8765") as websocket:
        await websocket.send("你好")
        response = await websocket.recv()
        print(response)

asyncio.get_event_loop().run_until_complete(connect())

优点是简单易懂,适合学习或小型项目。缺点是如果要集成到Web框架里(比如Flask、Django),就不太方便了。


2. 配合 Flask 使用 Flask-SocketIO 实现实时通信

如果你已经有一个Flask项目,想加WebSocket功能,推荐使用 Flask-SocketIO

安装依赖:

西亚购物系统 2004
西亚购物系统 2004

一套自选网上商城精美模版,自主商品管理,自行网店经营的网上商城平台,系统具有强大的商品管理、购物车、订单统计、会员管理等功能,同时拥有灵活多变的商品管理、新闻管理等功能,功能强劲的后台管理界面,无需登录FTP,通过IE浏览器即可管理整个网站。西亚购物平台经多方面权威调查和研究为您精心开发了很多特色实用功能。使商品展示、管理、服务全面升级。西亚购物平台为您提供了多款专业美观的店面样式、俱备完整的购物

下载
pip install flask-socketio eventlet

基本服务代码如下:

from flask import Flask, render_template
from flask_socketio import SocketIO, emit

app = Flask(__name__)
app.config['SECRET_KEY'] = 'secret!'
socketio = SocketIO(app)

@socketio.on('connect')
def handle_connect():
    print('客户端已连接')

@socketio.on('message')
def handle_message(data):
    print('收到消息:', data)
    emit('response', f'服务器回应: {data}')

if __name__ == '__main__':
    socketio.run(app, host='0.0.0.0', port=5000)

前端HTML部分可以用JavaScript连接:

<script src="https://cdn.socket.io/4.3.2/socket.io.min.js"></script>
<script>
  const socket = io('http://localhost:5000');
  socket.on('connect', () => {
    console.log('已连接到Flask WebSocket');
    socket.emit('message', 'Hello from client');
  });

  socket.on('response', (data) => {
    console.log('收到回复:', data);
  });
</script>

这种方式更适合已有Flask项目,或者需要结合REST API一起使用的场景。但注意,部署时最好配合 eventletgevent 才能支持并发连接。


3. Django + Channels:全栈WebSocket支持

如果你用的是Django,并且希望把WebSocket整合进现有项目,那就要用 Django Channels。它支持ASGI协议,可以同时处理HTTP和WebSocket请求。

安装:

pip install channels

配置步骤略多,主要修改点包括:

  • settings.py 中添加 'channels'INSTALLED_APPS
  • ASGI_APPLICATION 指向你的路由文件
  • 创建 consumers.py 处理WebSocket逻辑

一个简单的Consumer示例如下:

from channels.generic.websocket import AsyncWebsocketConsumer
import json

class ChatConsumer(AsyncWebsocketConsumer):
    async def connect(self):
        await self.accept()

    async def disconnect(self, close_code):
        pass

    async def receive(self, text_data):
        data = json.loads(text_data)
        message = data['message']
        await self.send(text_data=json.dumps({'response': message}))

然后在 routing.py 里定义路径:

from django.urls import re_path
from . import consumers

websocket_urlpatterns = [
    re_path(r'ws/chat/$', consumers.ChatConsumer),
]

这样就可以通过 /ws/chat/ 建立WebSocket连接了。

Channels的优势在于完整支持Django生态,适合大型项目。但上手门槛比前两个高一些,初期配置也稍微复杂。


小贴士:选择哪种方案?

  • 只是练手或小项目:用 websockets 库就够了。
  • 已有Flask项目:优先考虑 Flask-SocketIO
  • 已有Django项目:必须用 Channels
  • 性能要求高:可以考虑用Nginx+Gunicorn+Redis作为消息中间件来提升并发能力。

另外,WebSocket连接管理很重要。比如用户断开重连、广播消息、维护连接池等,这些细节在实际开发中都要考虑到。


基本上就这些。WebSocket开发虽然不算太复杂,但容易忽略连接管理和错误处理。刚开始可以先跑通最简例子,再逐步加上业务逻辑。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

246

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

522

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

610

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

693

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3618

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

54

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

71

2026.01.13

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号