hypercorn 启动 django channels 时连接被拒绝,主因是未显式启用 websocket(需 --ws 参数)、asgi.py 中 application 非可调用对象、监听地址为 127.0.0.1 而非 0.0.0.0,或 nginx 未透传 upgrade/connection 头。

Hypercorn 启动 Django Channels 时连接被拒绝
Hypercorn 默认不兼容 Django Channels 的 asgi.py 入口写法,尤其在未显式指定 ASGI 应用路径或未启用 WebSocket 支持时,Connection refused 很可能源于协议协商失败,而非端口占用。
- 确认启动命令是否包含
--ws参数(Hypercorn 0.14+ 必须显式开启 WebSocket 支持) - Django Channels 的
asgi.py中application必须是可调用对象,不能是字符串路径;Daphne 可容忍字符串,Hypercorn 不行 - 若用
hypercorn myproject.asgi:application报错,优先检查myproject/asgi.py是否有语法错误或未导入get_asgi_application() - Hypercorn 默认监听
127.0.0.1:8000,Daphne 默认监听0.0.0.0:8000;跨容器或远程访问时,需加--bind 0.0.0.0:8000
Daphne 在高并发长连接下 CPU 持续 90%+
Daphne 是纯 Python 实现的 ASGI 服务器,无内置异步 I/O 优化,在大量活跃 WebSocket 连接或频繁短轮询场景下,容易因事件循环阻塞导致 CPU 飙升,这不是配置问题,而是架构限制。
- 避免在生产环境用 Daphne 承载 >500 并发 WebSocket 连接;实测超过 300 连接后,单核 CPU 调度压力明显增大
- Daphne 不支持 HTTP/2,若前端使用
fetch()+AbortController频繁中断请求,会堆积未清理的连接状态 - 升级到 Django 4.2+ 后,Daphne 对
async def视图的协程调度仍有延迟,Hypercorn 的trio或asyncio后端响应更稳定 - 临时缓解可加
--max-connections 200限流,但治标不治本;真正需要的是换服务器或前置 Nginx 做连接复用
Hypercorn 多进程模式下 Session 数据不同步
Hypercorn 的 --workers 启用多进程后,若 Session 存在内存(如 django.contrib.sessions.backends.cache 未配分布式缓存),各进程间无法共享 session_key,导致登录态丢失或 CSRF 失败。
- Daphne 默认单进程,天然规避该问题;Hypercorn 多进程必须搭配 Redis 或 Memcached,不能用
file或cached_db后端 - 检查
settings.py中SESSION_ENGINE是否为django.contrib.sessions.backends.cache,且CACHES指向同一 Redis 实例 - 若用
hypercorn --workers 4 --bind unix:/tmp/hypercorn.sock,确保所有 worker 共享同一个缓存连接池,而非各自新建连接 - 开发时误用
--reload也会触发多进程 session 冲突,该模式仅用于本地调试,不可用于生产
部署时 Nginx 与 Hypercorn/Daphne 的 proxy_pass 差异
Nginx 转发到 ASGI 服务器时,Daphne 对 Upgrade 和 Connection 头处理较宽松,Hypercorn 更严格,稍有遗漏就会导致 WebSocket 握手 400 错误。
立即学习“Python免费学习笔记(深入)”;
- 必须在 Nginx 配置中显式透传 WebSocket 相关头:
proxy_set_header Upgrade $http_upgrade;、proxy_set_header Connection "upgrade"; - Daphne 允许
proxy_http_version 1.0,Hypercorn 要求proxy_http_version 1.1,否则 HTTP/1.0 请求会被直接关闭 - Hypercorn 默认启用
h11协议解析器,若 Nginx 开启了proxy_buffering on,可能截断分块响应;建议设为off并调大proxy_buffer_size - 用
curl -i -H "Connection: upgrade" -H "Upgrade: websocket"直连 ASGI 服务端口,能排除 Nginx 配置干扰
ASGI 服务器选型不是非此即彼的问题。Daphne 的“简单可靠”只在小流量、低复杂度场景成立;Hypercorn 的“高性能”需要你亲手填平 session、WebSocket、进程模型三处深坑——漏掉任何一个,线上表现可能比 Daphne 还差。










