django原生不支持websocket，因其同步架构与长连接本质冲突；必须通过channels引入asgi异步运行时和redis消息分发层，且protocoltyperouter中"http"须在前、"websocket"须用authmiddlewarestack包裹，路径正则末尾不可多加"/"，生产环境禁用内存通道层。
Django 原生不支持 WebSocket，这不是配置能绕过去的限制——runserver 根本不解析 ws:// 协议，直接访问只会 404 或静默断连。必须用 Channels + ASGI 才能跑通，且生产环境不能用内存层。
ASGI 入口和 ProtocolTypeRouter 顺序写反就全挂
很多人把 asgi.py 改成 Channels 版本后，仍收不到 WebSocket 连接，问题常出在 ProtocolTypeRouter 的键序上。HTTP 和 WebSocket 路由不是并列关系，而是协议分发：如果 "http" 写在后面，所有请求（包括 WebSocket 握手）都会被前面的 URLRouter 拦截并返回 404。
正确写法必须是：
application = ProtocolTypeRouter({
"http": get_asgi_application(),
"websocket": AuthMiddlewareStack(
URLRouter([
re_path(r"ws/chat/(?P<room_id>\w+)/$", ChatConsumer.as_asgi()),
])
),
})</room_id>
-
"http"必须在前，确保普通请求走 Django 原逻辑 -
"websocket"必须显式用AuthMiddlewareStack包一层，否则self.scope["user"]是空的 - 路径正则末尾不要加
$以外的字符，比如/，否则浏览器连ws://localhost:8000/ws/chat/abc123/会失败
CHANNEL_LAYERS 配错导致群发消息丢失
开发时图省事配 "BACKEND": "channels.layers.InMemoryChannelLayer"，本地单进程看似正常，但只要启动两个 daphne worker 或换用 uvicorn 多 worker，group_send() 就开始丢消息——因为内存层无法跨进程共享状态。Django Channels 4.x 已彻底移除对 locmem 的集群兼容支持。
生产环境唯一靠谱的选择是 Redis：
CHANNEL_LAYERS = {
"default": {
"BACKEND": "channels_redis.core.RedisChannelLayer",
"CONFIG": {
"hosts": [("127.0.0.1", 6379)],
},
},
}
- 装包必须是
channels-redis，不是redis-py；pip install channels channels-redis redis - 启动前先
redis-cli ping确认连得上，Channels 启动时不报错，但第一次group_send就卡住或超时 - 别信“开发环境随便用内存层”的说法——一旦你加了
channels-redis，InMemoryChannelLayer类名在 Channels 4.x 里根本不存在，会直接抛NameError
Consumer 里忘记 await self.accept() 就永远连不上
这是新手最常踩的坑：写了 connect() 方法，也做了用户校验，但没调 await self.accept()，结果浏览器 new WebSocket(...) 一直 pending，控制台显示 “WebSocket connection to ‘ws://…’ failed”。WebSocket 握手是服务端主动确认的过程，不 accept 就不算建立连接。
- 同步 Consumer 用
self.accept()，异步 Consumer 必须用await self.accept() - 如果校验失败要拒绝连接，必须用
await self.close(code=4003)，不能只return -
disconnect()里不用手动清理 channel name，Channels 会自动解绑；但如果你用了 Redis group，记得在disconnect里调await self.channel_layer.group_discard(...)，否则重连后可能收到旧消息
前端连的是 ws://，不是 http://
浏览器控制台报错 “Failed to construct 'WebSocket': The URL's scheme must be either 'ws' or 'wss'”，说明你写的地址还是 http://localhost:8000/ws/chat/xxx。HTTP 和 WebSocket 是完全不同的协议，端口可以一样，但 scheme 必须是 ws 或 wss。
- 开发时用
ws://127.0.0.1:8000/ws/chat/abc123/ - 上线后 Nginx 反代必须透传 Upgrade 和 Connection 头，否则握手失败；配置里漏掉这两行，前端永远卡在 pending
- 如果用 HTTPS 站点，前端必须用
wss://，且 ASGI 服务器（如daphne或uvicorn）得配 TLS，不能靠 Nginx 解密后再转ws://—— 那样会降级成非加密连接，现代浏览器直接拒绝
真正麻烦的从来不是写几行 AsyncWebsocketConsumer，而是 ASGI 生命周期、channel layer 状态同步、Nginx 协议透传这三者的咬合点——任何一个环节没对齐，消息就消失，连接就中断，日志还常常沉默。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
