Django Channels 是将 Django 升级为支持异步协议的通用应用服务器,需重写通信模型;WebSocketConsumer 适用于纯内存操作,涉及 I/O 必须用 AsyncWebsocketConsumer 并配合 sync_to_async;ASGI 路由分三层,缺一不可;群组需手动管理加入/离开,状态必须外存。

直接说结论:Django Channels 不是“给 Django 加个 WebSocket”,而是把 Django 从纯 HTTP 框架升级成支持异步协议的通用应用服务器——你得重写通信模型,不能只套用视图那一套。
WebSocketConsumer 和 AsyncWebsocketConsumer 的选择取决于你的逻辑是否阻塞
同步消费者 WebSocketConsumer 适合调用纯内存计算、简单状态更新;但只要涉及数据库查询、HTTP 请求、文件读写,就必须用 AsyncWebsocketConsumer,否则会阻塞整个事件循环。
- 用
sync_to_async()包裹 ORM 操作(比如await sync_to_async(User.objects.get)(id=1)),别在 async consumer 里直接写User.objects.get() - Django 4.2+ 默认开启
ASGI_APPLICATION,但channels_redis或channels-redis必须显式安装并配置CHANNEL_LAYERS,否则连接会静默断开 -
connect()方法里不主动调用self.accept(),客户端就卡在 pending 状态,浏览器控制台显示WebSocket connection to 'ws://...' failed
路由配置必须分层:ASGI → Protocol → Consumer
不是往 urls.py 里加一条 path 就行。Django Channels 的路由是三层结构:asgi.py 指向 ProtocolTypeRouter,再由 URLRouter 映射到具体 consumer,漏掉任何一层都会 404 或 500。
-
asgi.py中必须返回get_asgi_application()作为 http fallback,否则普通页面打不开 -
routing.py的 URL pattern 要带path,比如path('ws/chat/,不能只写/', ChatConsumer.as_asgi()) 'ws/chat/'——路径参数必须显式声明才能被 consumer 的self.scope['url_route']['kwargs']拿到 - 前端建立连接时,URL 必须和后端路由完全匹配,包括协议(
ws://或wss://)、域名、端口、路径,少一个斜杠都连不上
群组广播(Group)不是自动的,要自己管理加入/离开时机
channel_layer.group_add() 和 group_discard() 必须成对出现,且仅在 connect() 和 disconnect() 中调用——如果在 receive() 里误加,会导致同一连接被重复加入群组,消息发两遍。
- 群组名不能含空格或特殊字符,推荐用
f"chat_{room_id}"这种格式,否则channel_layer.group_send()会静默失败 -
group_send()发送的消息体必须是 dict,且 key 限定为字符串,value 只能是 JSON 序列化类型(datetime会报错),建议提前用json.dumps()处理再传入 - 群组消息不会自动推给发送者,如需回显,得在
receive()里先self.send()再group_send()
最常被忽略的是:Channels 的 consumer 实例是短生命周期的——每次 connect 都新建一个实例,disconnect 后立刻销毁。所有跨请求的状态(比如用户房间映射、在线人数计数)必须存到外部存储(Redis、数据库),不能靠类属性或模块变量硬扛。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











