Django Channels 4.0.0 WebSocket握手失败问题求助

以下是针对你遇到的WebSocket握手失败问题的排查方向和解决方法：

1. 路由配置中存在未定义的Consumer #

查看你的routing.py代码：

re_path(r"ws/chat/(?P<room_name>\w+)/$", consumers.SchataiConsumer.as_asgi()),

但你的consumers.py里仅定义了WsTestConsumer，不存在SchataiConsumer类，这会导致路由匹配时找不到对应的处理逻辑，直接拒绝握手请求。

解决方式：

• 直接删除这行错误的路由配置；
• 若确实需要该路由，在consumers.py中补充实现SchataiConsumer类。

2. 跨域Origin验证拦截 #

你使用AllowedHostsOriginValidator包裹了WebSocket中间件，而测试工具websocketking属于外部域名，不在Django的ALLOWED_HOSTS列表中，因此握手请求被拦截。

解决方式：

• 测试阶段可临时注释掉AllowedHostsOriginValidator，修改asgi.py：

application = ProtocolTypeRouter(
    {
        "http": django_asgi_app,
        "websocket": AuthMiddlewareStack(
            URLRouter(schatai.routing.websocket_urlpatterns)
        ),
    }
)

• 生产环境需指定允许的Origin，改用OriginValidator：

from channels.security.websocket import OriginValidator

# ...
"websocket": OriginValidator(
    AuthMiddlewareStack(URLRouter(schatai.routing.websocket_urlpatterns)),
    allowed_origins=["https://websocketking.com", "http://localhost:8000"]
),

3. 检查CHANNEL_LAYERS配置 #

你的WsTestConsumer中用到了channel_layer.group_send，但如果settings.py未正确配置CHANNEL_LAYERS，也会导致握手失败。

确认配置：
确保settings.py中包含正确的通道层配置，测试阶段用内存层即可：

CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "channels.layers.InMemoryChannelLayer",
    },
}

4. 验证请求URL正确性 #

确认在websocketking中使用的测试URL为ws://localhost:8000/ws/，端口、路径需与你的路由配置完全匹配，路径错误或端口不一致都会导致握手失败。

内容的提问来源于stack exchange，提问作者DJAMA Med