Django 本身不支持 WebSocket，必须使用 Channels 才能安全、可维护地集成；pip install "channels[daphne]" 是生产就绪的最小依赖组合，因 daphne 是官方推荐的 ASGI 服务器，原生支持 WebSocket 协议升级协商，缺装将导致部署时连接立即断开。
直接上结论：Django 本身不支持 WebSocket，必须用 channels 才能安全、可维护地集成；别碰自己手写 websockets 库 + Django 的“轻量方案”，它绕过 Django 认证/权限/ORM 异步限制，上线后大概率卡在用户绑定或数据库并发上。
安装 channels 时 pip 命令为什么必须带 [daphne]？
pip install "channels[daphne]" 是生产就绪的最小依赖组合。不加 [daphne] 会导致：
- 本地开发能跑，但部署时
runserver不处理 WebSocket 协议（HTTP 200 但连接立刻断开） -
daphne是 Channels 官方推荐的 ASGI 服务器，原生支持ws://和wss://升级协商；uvicorn虽然也能用，但需额外配置中间件兼容 Django 的 scope 结构 - 漏装会触发
ImportError: No module named 'daphne' when running daphne—— 这个错误常被误判为配置问题，其实是缺包
settings.py 中 INSTALLED_APPS 的顺序为什么不能错？
'daphne' 必须放在 'django.contrib.auth' 之前，否则 AuthMiddlewareStack 初始化失败，WebSocket 连接里 self.scope["user"] 永远是 AnonymousUser。
正确顺序示例：
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
INSTALLED_APPS = [
"daphne",
"django.contrib.admin",
"django.contrib.auth",
"channels", # 注意：channels 可以在 daphne 之后，但必须在 auth 之后
# ... 其他 app
]
-
daphne提供 ASGI 入口，要早于任何依赖它的中间件 -
channels本身不提供 ASGI server，只是协议路由和 channel layer 抽象，位置相对宽松 - 如果用
redis作 channel layer，channels_redis必须出现在channels之后，否则CHANNEL_LAYERS配置无效
asgi.py 里 ProtocolTypeRouter 的 "http" 键名不能写成 "https"
ASGI 协议层不区分 HTTP/HTTPS，加密由反向代理（Nginx、Cloudflare）处理。"http": django_asgi_app 是固定写法，写成 "https" 或 "websocket" 会导致整个 HTTP 请求 404 —— 因为 Daphne 根本不识别这个键。
- WebSocket 路由必须单独配在
"websocket"键下，且必须用AuthMiddlewareStack包裹，否则无法拿到登录态 - 常见错误：
application = URLRouter([...])直接赋值 —— 缺少ProtocolTypeRouter外壳，HTTP 和 WS 无法共存 - 调试技巧：启动后访问
http://localhost:8000/ws/chat/应返回 404（正常），而ws://localhost:8000/ws/chat/才应建立连接；如果 HTTP 地址返回 200，说明 routing 配置没生效
Consumer 类里 self.channel_layer.group_send 发不出消息？
90% 是 channel layer 没配 Redis 或配置未生效。Django Channels 默认用内存 channel layer（InMemoryChannelLayer），只适用于单进程开发，多 worker 或重启后消息丢失。
- 检查
CHANNEL_LAYERS是否在settings.py顶层定义（不能缩进、不能放在 if 分支里） - Redis 连接字符串格式必须是
redis://127.0.0.1:6379/0，末尾的/0是 database ID，漏写会连到默认 db 0 以外的位置 - 运行
python manage.py showmigrations channels确认 migrations 已加载（Channels 4+ 不需要 migrate，但旧版需执行） - Consumer 中调用
group_send前，先确认self.channel_layer不为None，否则静默失败
真正麻烦的不是配通，而是 Channel Layer 在负载均衡或多实例部署时，必须用 Redis —— 内存模式下 group_send 只发给本机 worker，其他机器上的连接收不到。这点容易被开发环境掩盖，上线才暴露。
