Redis 常见错误与连接问题

Redis 通过 RESP 协议返回字符串错误，不使用通用的数字错误码。客户端通常应匹配错误前缀或结构化字段（如 NOAUTH、WRONGPASS、MOVED），不要依赖整条文案完全一致。本页以 Redis 7.4.11 为基准；ACL、集群和客户端库可能返回更具体的消息。

权威来源见官方命令错误说明和 Redis Cluster 重定向规范。

常见错误

错误	含义	原因	解决方案
OOM command not allowed	内存超限	达到 maxmemory 且淘汰策略为 noeviction	增大 maxmemory 或更换淘汰策略
LOADING Redis is loading	正在加载数据	RDB/AOF 恢复中	等待加载完成
READONLY You can't write	只读副本	写请求发到了从节点	写操作发主节点
NOAUTH Authentication required	未认证	需要密码	AUTH password
ERR invalid password	传统密码认证失败	requirepass 密码不匹配	检查密码注入方式和 requirepass
WRONGPASS invalid username-password pair	ACL 用户名或密码错误	ACL 用户、密码或默认用户配置错误	使用 ACL WHOAMI、ACL LIST 核对身份
CROSSSLOT Keys in request	集群跨槽	多 key 操作不在同一槽	使用 {hashtag} 确保同槽
MOVED slot ip:port	集群重定向	客户端缓存过期	更新集群拓扑
ASK slot ip:port	槽迁移中	正在 resharding	发送 ASKING 后重试
ERR max number of clients	连接数超限	达到 maxclients	增大 maxclients 或排查连接泄漏
BUSYKEY Target key name	key 已存在	RENAME 目标 key 已存在	确认目标 Key 后使用 RENAMENX

客户端常见问题

现象	可能原因	排查方向
连接超时	网络/防火墙/bind 配置	检查 telnet、bind、protected-mode
连接被拒	端口、bind、protected-mode、maxclients 或进程状态异常	依次检查服务状态、监听地址、防火墙和 INFO clients
响应变慢	大 key / 阻塞命令	SLOWLOG GET 查看慢日志
内存持续增长	未设过期 / 内存泄漏	MEMORY DOCTOR 诊断

连接生命周期、重试边界和拓扑刷新见客户端连接与故障处理；认证与权限错误见安全与访问控制。