AWS Elastic Beanstalk部署的Django应用无法连接Redis ElastiCache

刚踩过几乎一模一样的坑，给你列几个关键排查步骤，按顺序来大概率能找到问题：

• 先确认网络连通性（最关键）
  别先纠结Django配置，直接在你的EB EC2实例上测试Redis连接：

  1. 用telnet测试端口：telnet your-redis-elasticache-endpoint 6379
  2. 或者装redis-cli（Amazon Linux用sudo yum install redis，Ubuntu用sudo apt-get install redis-tools），然后跑redis-cli -h your-redis-endpoint ping
     如果这两步失败，那就是网络问题：
  • 检查安全组：Redis的安全组入站规则必须允许你的EB EC2实例所在的安全组访问6379端口（来源选EC2的安全组ID，或者直接选"Same security group"），哪怕同安全组，默认不会自动开放！
  • 确认EC2和Redis在同一个VPC里，ElastiCache默认只允许VPC内访问，跨VPC需要额外配置 peering，一般EB创建的EC2和手动建的ElastiCache默认是同VPC，但最好去控制台确认下。
  • 检查EC2的子网路由表：确保能路由到Redis所在的子网，没有被NACL拦截。

• 检查Django的缓存配置是否正确
  网络通了之后，再看settings.py里的CACHES配置：
  首先确保你安装了django-redis（在requirements.txt里加上django-redis>=5.2.0，版本根据你的Django版本调整），然后配置示例：

  CACHES = {
      'default': {
          'BACKEND': 'django_redis.cache.RedisCache',
          # 非集群模式直接用单个端点，格式为redis://端点:端口/数据库编号
          'LOCATION': 'redis://your-redis-endpoint:6379/0',
          'OPTIONS': {
              'CLIENT_CLASS': 'django_redis.client.DefaultClient',
              # 如果你的Redis设置了密码，一定要加这行
              # 'PASSWORD': 'your-redis-auth-password',
          }
      }
  }
  

  另外，如果用EB环境变量传递Redis配置，要确保在settings里正确读取，比如os.environ.get('REDIS_HOST')，别写错变量名。

• 检查Redis ElastiCache的参数组
  去ElastiCache控制台看你的Redis参数组：

  • 是否开启了requirepass？如果有，Django配置里必须加PASSWORD参数，否则连接会被拒绝。
  • 是否设置了bind或者其他限制访问的参数？默认参数组一般没问题，但如果自定义过，要确认没有限制EC2的IP访问。

• 排除Django本身的问题
  可以写个简单的测试脚本在EC2上跑，跳过Django的缓存框架，直接用redis-py连接：

  import redis
  # 替换成你的Redis端点和端口
  r = redis.Redis(host='your-redis-endpoint', port=6379, db=0)
  print(r.ping())
  

  如果这个脚本能返回True，那说明Django的缓存配置有问题；如果也报错，那还是网络或者Redis的配置问题。

最后，部署完配置后，记得重启EB的应用（eb deploy或者控制台重启），确保新的settings生效！

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