Django连接远程Redis触发Broken pipe错误，本地Redis可正常运行

• 检查Redis的TCP闲置超时设置
  Redis默认会主动断开闲置过久的连接，如果timeout配置过短，Django客户端复用已断开的连接就会触发Broken pipe错误。

  1. 登录远程Redis主机，执行命令查看当前配置：redis-cli CONFIG GET timeout
  2. 如果返回值不是0（0表示禁用闲置超时），临时修改测试：redis-cli CONFIG SET timeout 0
  3. 重启Django服务验证，若问题解决，在redis.conf里永久修改timeout 0并重启Redis服务。

• 调整Django Redis客户端的连接池参数
  针对django-redis这类客户端，配置连接保活和自动重连，避免复用失效连接：
  在settings.py中更新Redis缓存配置：

  CACHES = {
      "default": {
          "BACKEND": "django_redis.cache.RedisCache",
          "LOCATION": "redis://devservices.orb.local:6379/0",
          "OPTIONS": {
              "CLIENT_CLASS": "django_redis.client.DefaultClient",
              "CONNECTION_POOL_KWARGS": {
                  "max_connections": 100,
                  "retry_on_timeout": True,
                  "socket_keepalive": True,
                  "socket_timeout": 30,
                  "socket_connect_timeout": 30,
              }
          }
      }
  }
  

  核心是开启socket_keepalive维持TCP连接，retry_on_timeout让客户端在连接失效时自动重试。

• 排查OrbStack的网络限制
  由于使用OrbStack提供主机，可能存在网络层的闲置连接回收机制：

  • 进入OrbStack的主机网络设置，检查是否有TCP连接超时的限制，尝试延长超时时间或关闭闲置回收。
  • 确认OrbStack的防火墙规则没有拦截Redis的持久连接流量。

• 验证Redis客户端与服务器版本兼容性
  版本不匹配也可能导致连接异常：

  1. 本地执行pip show redis查看Python客户端版本
  2. 远程执行redis-cli INFO server | grep redis_version查看Redis服务器版本
     若版本差异较大，升级或降级redis库到与服务器匹配的版本（比如Redis 6.x对应客户端版本≥3.5.0）。

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