Redis连接失败八成是环境或配置问题，需依次检查服务状态（redis-cli ping）、端口监听（ss/netstat）、bind/protected-mode配置、Docker网络模式、连接池复用（禁止单次请求新建实例）、密码与协议兼容性、云环境安全组及白名单。
Redis连接失败不是代码写错了，八成是环境或配置没对上——尤其在Web项目里，连接池复用、进程生命周期、网络拓扑三者一碰就出问题。
检查 Redis 服务是否真在监听目标地址和端口
ConnectionError: Error 111 / 10061 不是重试能解决的，它意味着 TCP 层根本没人应答。先确认服务端状态：
- 在 Redis 服务器上执行
redis-cli -h 127.0.0.1 -p 6379 ping，返回PONG才算通 - Linux 上跑
sudo ss -tlnp | grep :6379，看是否有redis-server在监听；Windows 用netstat -ano | findstr :6379 - 检查
redis.conf：如果只留bind 127.0.0.1，Web 服务部署在另一台机器或容器里就必然连不上；需注释掉或改成bind 0.0.0.0（配合protected-mode no或设requirepass） - Docker 场景下别用
localhost：Python 应用若也在容器中，应连redis（容器名）或host.docker.internal（Mac/Win），而不是宿主机127.0.0.1
避免每次请求都新建 redis.Redis() 实例
Flask、FastAPI 或 Django 视图函数里直接写 redis.Redis()，等于每秒创建上百个短连接，迅速打满 Redis 的 maxclients 限制，后续所有请求都会报 ConnectionError。
- 必须用单例 + 连接池：全局初始化一次
redis.Redis(connection_pool=pool)，其中pool = redis.ConnectionPool(...) - 连接池关键参数建议：
max_connections=50（别盲目调高）、health_check_interval=30（每 30 秒发 PING 清理失效连接）、socket_keepalive=True - 别混用
redis-py6.x 和 7.x 客户端：协议不兼容，连接池无法复用，状态混乱后容易偶发 ConnectionError
密码、协议与 decode_responses 必须显式传参
靠默认值很容易踩坑，尤其 Web 项目启动时看似正常，压测或上线后才暴露问题。
立即学习“Python免费学习笔记（深入）”；
- 密码错误时，
redis-cli -a wrongpwd ping会报NOAUTH Authentication required，但 Python 客户端可能只抛 ConnectionError，掩盖真实原因；务必用redis-cli -a yourpass ping先验证 - Redis 6.2+ 默认启用 RESP3，而某些旧版
redis-py（如 4.x）不兼容；加protocol=2强制降级：redis.Redis(..., protocol=2) -
decode_responses=True必须显式开启，否则get()返回bytes，后续 JSON 解析或字符串操作直接 TypeError - 连接超时别只设
socket_connect_timeout，还要配socket_timeout防止命令卡死
云环境常见网络层拦截点
本地能连，上云就挂？大概率是安全组、白名单或 VPC 隔离导致的“连接被拒绝”，而非代码问题。
- ECS 和 Redis 实例不在同一 VPC：跨 VPC 访问需配置 VPC 对等连接，不能仅靠公网 IP
- 安全组未放行：Redis 实例的安全组必须允许 ECS 所在安全组的入方向流量（端口 6379/TCP）
- 白名单开启但 IP 未加：云厂商 Redis 实例常默认开启白名单，ECS 公网 IP 变更后必须手动更新
- 公网访问被关闭：弹性公网 IP 被解绑后，控制台“公网访问”开关会自动关闭，需重新开启并绑定
最易被忽略的是：连接池健康检查开了但没配 retry_on_timeout=True，导致健康检查本身因网络抖动失败，把好连接误判为坏连接剔除；还有就是开发时用 Docker Compose 跑通了，上线却忘了改 host 从 redis 切成实际内网地址——这种细节错一个，整个缓存链路就静默失效。
