redis-connection-failed

Redis 连接失败的定位与修复

现象

客户端报 Connection refused、Connection timed out、NOAUTH、WRONGPASS 或 READONLY。应用启动时连不上 Redis，或运行中频繁断连。

快速定位

redis-cli -h <host> -p 6379 ping
redis-cli -h <host> -p 6379 --tls --cacert ca.crt ping
ss -lntp | grep 6379
redis-cli -h <host> -p 6379 INFO server
redis-cli -h <host> -p 6379 ACL WHOAMI
redis-cli -h <host> -p 6379 CLIENT LIST
redis-cli -h <host> -p 6379 INFO clients

集群模式：

redis-cli -c -h <host> -p 6379 cluster info
redis-cli -c -h <host> -p 6379 cluster nodes

常见根因

1. Redis 未启动、端口错误或只监听 127.0.0.1。
2. requirepass/ACL 配置变更，客户端密码或用户名不匹配。
3. protected-mode、防火墙、安全组或 TLS 配置阻断连接。
4. maxclients 达到上限，新连接被拒绝。
5. 集群模式下客户端没加 -c，或访问了错误节点。
6. 连到只读副本执行写操作，返回 READONLY。

修复

• 先用 redis-cli ping 区分网络、认证和服务问题。
• 检查 bind、protected-mode、防火墙和 TLS 端口。
• 核对密码/ACL 用户，更新客户端配置并重启连接池。
• 调整 maxclients 和文件描述符限制，排查连接泄漏。
• 集群确认拓扑、槽位和客户端重定向配置。

相关命令

• redis-cli — 连接与诊断
• ss — 端口监听
• redis-benchmark — 连通性压测