Heroku部署Django-Channels项目WebSocket连接失败求助

针对你在Heroku部署Django Channels项目时遇到的WebSocket连接失败问题，以下是针对性的排查步骤和解决方法：

1. 校验ASGI服务器与通道层配置 #

确认asgi.py配置正确性 #

确保文件正确集成Channels的路由规则，示例如下：

import os
import django
from channels.routing import ProtocolTypeRouter, URLRouter
from channels.auth import AuthMiddlewareStack
from django.core.asgi import get_asgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project.settings')
django.setup()

from chats.routing import websocket_urlpatterns

application = ProtocolTypeRouter({
    "http": get_asgi_application(),
    "websocket": AuthMiddlewareStack(
        URLRouter(websocket_urlpatterns)
    ),
})

检查settings.py中Redis通道层配置 #

直接使用Heroku提供的REDIS_URL环境变量即可，无需拆分密码/端口：

import os

CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "channels_redis.core.RedisChannelLayer",
        "CONFIG": {
            "hosts": [os.environ.get('REDIS_URL')],
        },
    },
}

2. 修正Heroku Procfile配置 #

必须使用Daphne作为ASGI服务器替代Gunicorn，Procfile内容应为：

web: daphne your_project.asgi:application --port $PORT --bind 0.0.0.0

同时确保requirements.txt包含必要依赖：

daphne>=4.0.0
channels>=4.0.0
channels-redis>=4.1.0

3. 核对WebSocket路由匹配 #

确认chats/routing.py中的路径与前端请求的/wss/chat/完全一致，注意正则表达式的结尾匹配：

from django.urls import re_path
from . import consumers

websocket_urlpatterns = [
    re_path(r'wss/chat/$', consumers.ChatConsumer.as_asgi()),
]

4. 查看Heroku实时日志定位错误 #

运行命令查看后端日志，捕捉连接失败时的具体报错：

heroku logs --tail

重点关注：Redis连接超时、路由匹配失败、ASGI服务启动异常等信息。

5. 优化前端WebSocket URL生成逻辑 #

避免硬编码协议，自动适配生产/开发环境：

const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
const chatSocket = new WebSocket(`${protocol}//${window.location.host}/wss/chat/`);

6. 检查Heroku应用基础设置 #

• 确认Redis插件已绑定到当前应用，REDIS_URL环境变量存在且有效
• 确认Heroku应用已启用SSL（默认已开启），保证wss协议正常通行

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