Django Channels：WebSocket连接失败问题求助

以下是针对你的WebSocket连接失败问题的实用排查步骤：

• 确认使用ASGI服务器运行
  Django默认的runserver是WSGI服务器，不支持WebSocket协议。必须使用ASGI服务器启动项目，比如daphne或uvicorn，启动命令示例：

  daphne your_project.asgi:application
  # 或
  uvicorn your_project.asgi:application --port 8000
  

  启动时要确保控制台无报错，服务器正常监听8000端口。

• 验证WebSocket路由配置
  检查项目的routing.py，确保路由规则和你请求的URL匹配：

  from django.urls import re_path
  from . import consumers
  
  # 对应/ws/tech/的路由规则
  websocket_urlpatterns = [
      re_path(r'ws/(?P<room_name>\w+)/$', consumers.ChatConsumer.as_asgi()),
  ]
  # 如果是/room/ws/tech/，路由要修改为：
  # re_path(r'room/ws/(?P<room_name>\w+)/$', consumers.ChatConsumer.as_asgi()),
  

  同时确认asgi.py正确集成了Channels路由：

  import os
  from django.core.asgi import get_asgi_application
  from channels.routing import ProtocolTypeRouter, URLRouter
  from channels.auth import AuthMiddlewareStack
  import your_app.routing
  
  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project.settings')
  
  application = ProtocolTypeRouter({
      "http": get_asgi_application(),
      "websocket": AuthMiddlewareStack(
          URLRouter(your_app.routing.websocket_urlpatterns)
      ),
  })
  

• 检查消费者类实现
  确保消费者类正确继承并实现了connect方法，关键是要调用accept()完成连接：

  # 异步消费者示例
  from channels.generic.websocket import AsyncWebsocketConsumer
  
  class ChatConsumer(AsyncWebsocketConsumer):
      async def connect(self):
          self.room_name = self.scope['url_route']['kwargs']['room_name']
          self.room_group_name = f'chat_{self.room_name}'
  
          await self.channel_layer.group_add(
              self.room_group_name,
              self.channel_name
          )
          await self.accept()  # 必须调用此方法，否则连接会被拒绝
  
      # 其他方法如disconnect、receive...
  

  同步消费者则使用self.accept()（无需await）。

• 确认CHANNEL_LAYERS配置
  在settings.py中检查通道层配置，本地开发可使用内存层：

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

  若使用Redis作为通道层，需确保Redis服务运行正常，且已安装channels_redis包。

• 查看浏览器详细错误信息
  打开浏览器开发者工具（F12）的「网络」标签，找到WebSocket请求，查看响应状态码（如404表示路由不匹配，500表示服务器内部错误）和控制台的具体报错，这能快速定位问题根源。

• 排查权限与中间件影响
  如果应用有登录验证逻辑，需确保WebSocket路由未被权限中间件拦截，或在消费者的connect方法中正确处理权限校验，避免因权限问题被拒绝连接。

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