Django Channels 4.0.0+Docker Redis运行数天后停止推送消息求助

问题描述 #

当前技术栈：

• Django 4.1.3 + Channels 4.0.0
• Docker部署的Redis:latest（配置见下方）
• 服务通过Daphne 4.0.0运行
• 前端基于React，使用reconnecting-websocket维持WebSocket长连接

遇到的问题：服务稳定运行1-2天后，前端完全无法接收Channels推送的消息；重启Redis容器后问题暂时恢复，但间隔1-2天会再次出现。

Redis的docker-compose配置：

services:
  ...

  redis:
    image: redis
    ports:
      - "6379:6379"
    container_name: redis
    restart: always
    command: redis-server --appendonly yes --replica-read-only no

可能的原因及解决方法 #

1. Redis连接池耗尽或连接未正确回收 #

Channels依赖Redis作为消息中间件，如果Channels/Daphne的Redis连接未正确关闭，会导致Redis连接数持续增长直至达到上限，新的推送消息无法被处理。

解决措施：

• 在Djangosettings.py的通道层配置中添加连接池参数，控制连接生命周期：

  CHANNEL_LAYERS = {
      "default": {
          "BACKEND": "channels_redis.core.RedisChannelLayer",
          "CONFIG": {
              "hosts": [("redis", 6379)],
              "pool_size": 10,  # 根据业务并发量调整
              "conn_max_age": 60,  # 自动回收闲置60秒以上的连接
          },
      },
  }
  

• 进入Redis容器执行redis-cli info clients，查看connected_clients数值是否持续攀升。如果已接近Redis默认最大连接数（10000），可以通过修改Redis启动命令增大上限：

  command: redis-server --appendonly yes --replica-read-only no --maxclients 20000
  

2. Redis内存溢出导致阻塞 #

如果Channels推送的消息未及时清理，Redis内存占用会持续升高，引发响应变慢甚至阻塞，无法处理新的推送请求。

解决措施：

• 配置Redis内存淘汰策略，避免内存耗尽：

  command: redis-server --appendonly yes --replica-read-only no --maxmemory 512mb --maxmemory-policy allkeys-lru
  

  其中maxmemory根据服务器可用内存调整，allkeys-lru表示内存达上限时淘汰最近最少使用的键。
• 检查Channels相关键的过期时间：进入Redis执行keys *channel*匹配Channels的键，再用TTL [键名]查看是否有永久有效的键。如果存在，需在业务逻辑中为通道键添加过期设置，或确认Channels默认的过期机制是否正常生效。

3. Daphne/Channels进程异常或连接管理失效 #

Daphne worker进程长时间运行可能出现内存泄漏，或用户断开WebSocket连接后，Channels未及时将其从推送组中移除，导致消息推送到无效通道。

解决措施：

• 给Daphne添加健康检查，自动重启异常进程：

  daphne:
    ...
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s
    restart: always
  

  同时在Django中新增一个健康检查接口，返回200状态码即可。
• 检查WebSocket断开事件的处理逻辑：确保在用户断开连接时，调用group_discard将其从对应的推送组中移除，避免无效的消息推送。

4. Redis AOF持久化引发的IO阻塞 #

当前开启了appendonly yes，AOF持久化的磁盘IO操作如果出现阻塞，会拖慢Redis的消息处理能力。

解决措施：

• 调整AOF同步策略，平衡性能与数据安全性：

  command: redis-server --appendonly yes --replica-read-only no --appendfsync everysec
  

  everysec表示每秒同步一次，是性能与安全性的折中方案；如果对数据一致性要求不高，可改为no由操作系统控制同步时机。
• 开启AOF自动重写：Redis默认已开启auto-aof-rewrite-percentage（默认100）和auto-aof-rewrite-min-size（默认64mb），当AOF文件大小增长超过指定比例且达到最小容量时，自动触发重写优化文件体积，避免大文件引发IO压力。

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