Django Channels报"Temporary failure in name resolution"如何排查

核心错误根因 #

该报错本质是Django进程无法将redis主机名解析为对应IP地址，问题出在Django服务到Redis的网络连通性，和前端WebSocket配置、ASGI路由配置无关。

排查思路 #

• 检查docker-compose服务网络配置：确认Django服务和Redis服务是否归属同一个compose自定义网络，默认同一份compose文件内的服务会加入默认网络支持服务名互解析，若显式配置network字段将二者拆分到不同网络则会解析失败
• 核查Redis服务名拼写：确认compose文件中Redis服务的名称是否严格为redis，服务名大小写敏感，拼写错误会直接导致解析失败
• 进入Django容器验证连通性：执行docker exec -it <Django容器名> bash进入容器，先后执行ping redis验证域名解析、nc -zv redis 6379验证端口连通性，可直接定位是否为网络层面问题
• 检查服务启动顺序：若Django服务早于Redis服务启动，Redis未完成网络注册时会出现偶发解析失败，可查看compose是否配置depends_on字段指定启动依赖
• 验证依赖版本兼容性：确认channels与channels_redis版本匹配，比如channels 4.x要求channels_redis版本≥4.0，低版本适配问题也可能抛出同类异常

解决方案 #

• 修正docker-compose编排配置，确保Redis服务名正确、两个服务归属同一网络，参考配置如下：

services:
  redis:
    image: redis:7-alpine
    restart: always
  web:
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/code
    ports:
      - "8000:8000"
    depends_on:
      - redis

• 若Django未使用容器部署、仅Redis通过容器运行，需将CHANNEL_LAYERS配置修改为"hosts": ["redis://localhost:6379"]，本地运行的Django不在compose网络内，无法解析redis服务名
• 因启动顺序导致的偶发故障，直接重启Django服务即可，也可在Django启动逻辑中增加Redis连接重试机制
• 版本不兼容问题执行pip install -U channels channels_redis升级到匹配的稳定版本即可

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