Django WebSocket连接失败排查：按文档配置仍无法建立连接

• 使用正确的ASGI服务器启动
  不要用Django默认的runserver命令启动应用，它仅支持WSGI协议。必须用ASGI兼容服务器，比如daphne或uvicorn：

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

• 确认ASGI配置正确性

  • 检查settings.py中INSTALLED_APPS是否包含channels，ASGI_APPLICATION是否正确指向项目的ASGI应用（如your_project.asgi.application），避免拼写错误。
  • 检查asgi.py是否正确配置协议路由，示例：

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

• 验证WebSocket路由与Consumer逻辑

  • 确保routing.py中的websocket_urlpatterns完全匹配前端连接路径ws://127.0.0.1:8000/ws/serial/，比如路由定义为path('ws/serial/', YourConsumer.as_asgi())，注意路径末尾斜杠的一致性。
  • 检查AsyncWebsocketConsumer的connect方法是否正确调用了await self.accept()，且方法内未抛出未处理的异常——任何未捕获的错误都会导致连接被强制关闭。

• 排查跨域与权限限制
  若前端与后端存在跨域场景（即使本地测试也可能因端口/域名差异触发），需确保WebSocket请求被允许。可在settings.py中配置CHANNEL_LAYERS（需安装channels-redis），或检查是否有第三方中间件拦截了WebSocket连接。

• 查看服务器日志定位问题
  启动ASGI服务器时，观察控制台输出的日志信息，路由匹配失败、Consumer初始化错误、权限校验失败等问题都会在日志中明确体现，这是快速定位问题的关键。

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