Django Views 无法实现实时聊天，因 HTTP 是无状态短连接，需重连通信，轮询则浪费资源；Channels 通过 ASGI 接入 WebSocket，需改启动方式、路由（routing.py）与消费者模型，依赖 Redis 实现跨进程群聊广播。
为什么直接用 Django Views 做不了实时聊天
因为 HTTP 是无状态短连接，用户发一条消息就要重连一次，轮询又浪费资源。Django Channels 把 WebSocket 协议接入 Django 生态，让 ASGI 代替 WSGI 处理长连接——这不是“加个插件就能跑”，而是要改启动方式、路由逻辑和视图模型。
常见错误现象：WebSocket connection failed: Error during WebSocket handshake，基本是没把 asgi.py 设为入口，或 Nginx 没透传 Upgrade 和 Connection 头。
- 必须用
daphne或uvicorn --asgi启动，不能用python manage.py runserver -
settings.py中要设ASGI_APPLICATION = "myproject.asgi.application"，不是ROOT_URLCONF - WebSocket 路由写在
routing.py，和urls.py完全隔离，不走 Django 的 URLResolver
如何定义一个基础的聊天 Consumer
Consumer 是 Channels 的核心单元，类似 Django 的 View，但处理的是异步事件流。别写成同步函数——async def connect(self) 和 await self.accept() 是硬性要求，漏掉 await 会导致连接立即断开。
示例片段（consumers.py）：
立即学习“Python免费学习笔记（深入）”；
from channels.generic.websocket import AsyncWebsocketConsumer
import json
class ChatConsumer(AsyncWebsocketConsumer):
async def connect(self):
self.room_name = self.scope["url_route"]["kwargs"]["room_name"]
self.room_group_name = f"chat_{self.room_name}"
await self.channel_layer.group_add(self.room_group_name, self.channel_name)
await self.accept()
async def disconnect(self, close_code):
await self.channel_layer.group_discard(self.room_group_name, self.channel_name)
async def receive(self, text_data):
data = json.loads(text_data)
message = data["message"]
await self.channel_layer.group_send(
self.room_group_name,
{"type": "chat.message", "message": message}
)
async def chat_message(self, event):
message = event["message"]
await self.send(text_data=json.dumps({"message": message}))
注意点：
-
self.channel_layer.group_add()必须在accept()之后调用，否则组播会失败 -
"type": "chat.message"中的chat.message会映射到同名方法chat_message，命名必须一致且用下划线 - 前端发来的
text_data是字符串，json.loads是必须步骤，别漏
前端怎么连上 WebSocket 并收发消息
浏览器原生 WebSocket API 不支持带认证头，所以登录态得塞进 URL 或用 Cookie。Django Channels 默认读取 session 和 user 信息，但前提是连接时已带有效 Cookie（即用户已通过 Django 登录）。
关键代码（JS）：
const roomName = document.getElementById("room-name").dataset.roomName;
const wsUrl = `ws://${window.location.host}/ws/chat/${roomName}/`;
const chatSocket = new WebSocket(wsUrl);
chatSocket.onmessage = function(e) {
const data = JSON.parse(e.data);
document.getElementById("chat-log").innerHTML += `<div>${data.message}</div>`;
};
chatSocket.onopen = function() {
console.log("WebSocket connected");
};
document.getElementById("chat-message-input").onkeyup = function(e) {
if (e.keyCode === 13) { // Enter key
const messageInputDom = document.getElementById("chat-message-input");
const message = messageInputDom.value;
chatSocket.send(JSON.stringify({"message": message}));
messageInputDom.value = "";
}
};
容易踩的坑：
- URL 必须以
ws://或wss://开头，http://会静默失败 -
chatSocket.send()只接受字符串，必须JSON.stringify，否则后端json.loads报错 - 如果用 Nginx 反代，需显式配置：
proxy_http_version 1.1;、proxy_set_header Upgrade $http_upgrade;、proxy_set_header Connection "upgrade";
怎样让多人消息真正广播到所有客户端
单靠 self.send() 只能回传给自己，要实现群聊，必须用 channel_layer.group_send() + group_add() 组机制。很多人卡在这一步：消息发出去了，但只有发送者自己看到。
检查点：
- 确认
CHANNEL_LAYERS配置用了 Redis（channels_redis），本地内存层InMemoryChannelLayer不跨进程，多 worker 时失效 -
self.room_group_name要全局唯一且稳定，别用随机数或时间戳，否则不同用户加入不同 group -
chat_message方法里用self.send()，不是self.channel_layer.group_send()——后者会无限递归 - 如果用 Docker，确保 Redis 容器和 Daphne 容器在同一个网络，且
redis://redis:6379地址可连通
Redis 不是可选项，是必选项；group 名里的特殊字符（比如空格、斜杠）要清理，不然 channel_layer 会静默丢弃消息。
