Django3+Channels3部署AWS EB+ElastiCache后跨网络无法收发Websocket消息如何解决

1. 优先排查AWS负载均衡与CDN配置（出现概率最高） #

• 确认负载均衡（ALB/NLB）的空闲超时时间配置≥300秒，且大于你的WebSocket心跳间隔：AWS ALB默认空闲超时为60秒，跨网场景下无数据传输的连接会被自动掐断，形成表面连接正常、实际无法收发数据的半开连接
• 检查ALB侦听器的头转发规则：针对WebSocket请求必须强制转发Upgrade和Connection头，EB的Nginx配置中要显式添加以下规则，通常匹配/ws/前缀的请求全部走该规则：

location /ws/ {
    proxy_pass http://127.0.0.1:8001; # 替换为你的daphne监听地址
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

• 如果你使用了CloudFront等CDN服务，确认CDN已开启WebSocket支持，且CDN的空闲超时时间与ALB配置一致
• 检查安全组规则：ALB安全组入站规则允许所有来源的80/443端口访问，没有仅开放公司内网网段限制；EB实例安全组出站规则允许全网段访问ElastiCache Redis的6379端口

2. 排查Django Channels通道层配置 #

• 确认依赖版本匹配：Channels 3要求channels-redis版本≥3.0.0，可执行pip list | grep channels-redis验证
• 检查settings.py中通道层配置，非集群版Redis不要开启集群相关配置，直接写死Redis端点：

CHANNEL_LAYERS = {
    'default': {
        'BACKEND': 'channels_redis.core.RedisChannelLayer',
        'CONFIG': {
            "hosts": [('你的ElastiCache Redis私有端点', 6379)],
        },
    },
}

• 线上环境手动测试通道层消息发送：登录EB实例执行python manage.py shell运行以下代码，无报错则通道层配置正常：

import channels.layers
from asgiref.sync import async_to_sync
channel_layer = channels.layers.get_channel_layer()
# 测试消息发送
async_to_sync(channel_layer.group_send)("test_group", {"type": "test.message", "text": "cross_net_test"})

3. 排查前后端连接保活配置 #

• 前端必须配置WebSocket心跳机制：每20-30秒向后端发送一次心跳包，后端收到后立即返回响应，避免跨网运营商的中间节点杀掉长期无流量的TCP连接
• 前端添加onerror、onclose事件埋点日志，确认跨网场景下连接是否真的处于活跃状态，排除半开连接的情况
• 确认前端WebSocket连接地址为公网可访问的ALB域名，没有硬编码公司内网IP或内网域名

4. 排查EB服务进程配置 #

• 检查Procfile配置，确保daphne与gunicorn进程都正常启动，示例配置：

web: gunicorn --workers=2 --bind=127.0.0.1:8000 your_project.wsgi:application
websocket: daphne -b 127.0.0.1 -p 8001 your_project.asgi:application

• 检查supervisor配置，确认daphne进程无崩溃重启日志，监听地址为127.0.0.1或0.0.0.0，没有绑定实例私有IP

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