使用Django-Channels时WebSocket连接失败问题求助

一、先排查最容易忽略的基础配置 #

1. 确认ASGI服务器启动方式 #

你是不是直接用python manage.py runserver启动的？Django自带的runserver默认用WSGI模式，没法处理WebSocket请求，必须加--asgi参数切换到ASGI模式：

python manage.py runserver --asgi

没加这个参数的话，WSGI服务器会直接拒绝WebSocket连接，这是最常见的触发原因。

2. 检查路由冲突 #

你的WebSocket路由是path("", ChatConsumer.as_asgi())，如果你的HTTP视图chatPage对应的URL也是根路径/，那么WebSocket请求会被HTTP视图拦截，直接导致连接失败。

解决方法：给WebSocket设置专属路径，比如：

# routing.py
websocket_urlpatterns = [
    path("ws/", ChatConsumer.as_asgi()),
]

同时修改前端JS的WebSocket地址：

const chatSocket = new WebSocket("ws://" + window.location.host + "/ws/");

3. 验证中间件权限问题 #

你用了AuthMiddlewareStack，这个中间件要求用户必须登录才能建立WebSocket连接。如果你的chatPage允许匿名访问，未登录用户的请求会直接被拒绝。

可以先换成SessionMiddlewareStack测试：

# asgi.py
from channels.sessions import SessionMiddlewareStack

application = ProtocolTypeRouter(
    {
        "http": get_asgi_application(),
        "websocket": SessionMiddlewareStack(
            URLRouter(
                routing.websocket_urlpatterns
            )
        )
    }
)

二、Channel Layers相关问题排查 #

你当前用的InMemoryChannelLayer在Windows环境下确实容易出问题——Windows的进程模型和Unix系统不同，内存层的多进程共享机制会有兼容性缺陷。

1. 快速验证Channel Layer是否正常 #

在Django Shell里执行以下代码，测试Channel Layer能否正常工作：

from channels.layers import get_channel_layer
import asyncio

layer = get_channel_layer()
asyncio.run(layer.group_add('test_group', 'test_channel'))
asyncio.run(layer.group_send('test_group', {'type': 'test.message', 'text': 'hello'}))

如果执行报错，说明内存Channel Layer确实无法正常运行。

2. 切换到Redis后的效果 #

切换到Redis Channel Layer后，兼容性会大幅提升——Redis是独立进程，不受Django进程模型影响，基本能解决Windows下内存层的问题。

配置步骤：

1. 安装依赖：

pip install channels_redis

2. 修改settings.py的CHANNEL_LAYERS配置：

CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "channels_redis.core.RedisChannelLayer",
        "CONFIG": {
            "hosts": [("127.0.0.1", 6379)],
        },
    },
}

3. 确保本地Redis服务已经启动。

三、其他排查小技巧 #

• 打开浏览器控制台的Network标签，查看WebSocket请求的响应状态码：403代表权限问题，404代表路由匹配失败，能帮你精准定位问题。
• 确认channels已经添加到settings.py的INSTALLED_APPS中：

INSTALLED_APPS = [
    ...
    'channels',
    ...
]

内容的提问来源于stack exchange，提问作者Murad Mustafayev