生产环境必须用 Redis（或 RabbitMQ），因 Django 5 + Channels 4.x 已彻底移除 in-memory 层的集群支持；本地用 locmem 会丢消息，因其仅单进程有效，多 worker 下内存隔离导致 group 广播静默失败，且 Channels 4.0+ 已删除 channels.layers.InMemoryChannelLayer 类。
生产环境必须用 Redis（或 RabbitMQ），Django 5 + Channels 4.x 已彻底移除 in-memory 层的集群支持，单 worker 调试除外。
为什么本地用 locmem 会丢消息？
Channels 4.0+ 根本不识别 channels.layers.InMemoryChannelLayer 这个类名——它已被删除。即使你硬写进去，启动时不会报错，但多 worker 下所有广播、群发、跨进程通信都会静默失败。
常见现象：ChannelFull 频发、ChatConsumer 收不到 group_send、WebSocket 连上立刻断开且日志空空如也。
- in-memory 层只在单进程、单线程下“看起来能跑”，本质是内存隔离的 fake channel layer
- Django 5 的 ASGI server（如 Daphne/Uvicorn）默认启多个 worker，一开就踩坑
- Redis 不是“可选优化”，而是 Channel Layer 协议的基础设施：必须支持 publish/subscribe + TTL + 多实例共享状态
CHANNEL_LAYERS 配置要避开哪些硬编码陷阱？
别直接写死 redis://localhost:6379/0 —— 开发、测试、CI、生产环境的 Redis 地址/DB/密码都不同，硬编码会导致部署失败或连错库。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
立即学习“Python免费学习笔记（深入）”；
- 用环境变量注入：
os.getenv("REDIS_URL", "redis://127.0.0.1:6379/0") - hosts 列表里别写字符串，必须是
[("127.0.0.1", 6379)]元组，写成["127.0.0.1:6379"]会报TypeError: 'str' object is not iterable - 如果 Redis 开了密码，CONFIG 里加
"password": "yourpass"，否则连接被拒绝但无明确错误 - 别漏装
redis包（不是redis-py）：pip install redis channels-redis
怎么确认 Redis 真连上了，而不是假成功？
Channels 启动时不校验 Redis 可用性，只有第一次 channel_layer.group_send() 才会阻塞或超时。所以得主动测。
- 先终端执行：
redis-cli -h 127.0.0.1 -p 6379 ping，返回PONG才算通 - 在 Django shell 里快速验证：
from channels.layers import get_channel_layer<br>import asyncio<br>layer = get_channel_layer()<br>asyncio.run(layer.group_add("test", "test.key"))不报错即基础通 - 检查
settings.py中是否误把CHANNEL_LAYERS写在INSTALLED_APPS下面——顺序无关，但放错位置容易漏看
asgi.py 和 routing.py 哪里最容易配反？
最常出问题的是 ProtocolTypeRouter 里 http 和 websocket 的顺序，以及 routing 没被 asgi 加载。
- 务必保证
http在前、websocket在后；如果反过来，所有请求都被 URLRouter 拦截，WebSocket 升级失败 -
routing.py必须显式导入并赋值给application，不能只写ProtocolTypeRouter({...})就完事 - 浏览器连接地址必须是
ws://127.0.0.1:8000/ws/chat/abc123/，用http://会触发ERR_CONNECTION_REFUSED，这不是后端问题，是协议错 - 路径正则别漏末尾
$：re_path(r"ws/chat/(?P<room_id>\w+)/$", ...)，否则可能匹配到静态文件路由
真正麻烦的从来不是写几行 consumer 代码，而是 channel_layer 在后台悄无声息地失效——它不报错，只丢消息。每次上线前，盯住 redis-cli monitor 看有没有 PUBLISH 流量，比读十遍文档都管用。
