Redis报WRONGTYPE:先查键类型
Redis 返回 WRONGTYPE,通常表示命令需要的数据类型与这个键实际保存的类型不一致。例如程序把用户信息当哈希读取,某个旧版本却把同名键写成了 JSON 字符串。连接正常、密码正确也会报错,重启服务不会自动修正数据结构。
以下以 Redis 7 及以上常用数据类型为例。排查先读取元数据,不删除键,也不使用写入命令把现有内容覆盖成“想要的类型”。
先拿到完整键名和失败命令
从应用错误日志记录失败命令、发生时间、完整键名、连接地址、端口和逻辑数据库编号。确认客户端有没有自动加环境、租户或业务前缀;代码里写的 user:1001,实际可能是另一个完整名称。日志只保留诊断所需字段,别把密码、会话令牌和整份用户数据一起打印。
按应用的实际连接方式检查。下面只是本机连接示例,替换账户、地址与数据库编号,密码通过提示输入:
redis-cli -h 127.0.0.1 -p 6379 --user your_user --askpass -n 0
原连接使用 TLS 或隧道时保持原方式。Redis Cluster 只使用数据库 0,不能通过切换其他逻辑库排查。也要区分主节点与副本,避免拿不同时间、不同节点上的结果相互证明。
用只读命令确认它现在是什么
进入 Redis 提示符后,把示例替换成刚才记录的真实键名:
TYPE site:user:1001
TTL site:user:1001
TYPE 返回 string、hash、list 等实际类型;返回 none 表示此刻这个连接所选数据库中不存在该键。TTL 的非负值为剩余秒数,-1 表示存在但没有到期时间,-2 表示键不存在。
两次查询不是一个原子快照,期间可能有过期或并发写入。如果现场结果与日志不同,保留时间和应用版本继续定位,不能立即认定日志错误或数据丢失。涉及多个键的失败命令,应逐一核对参与的实际键名。
| 常见 TYPE 结果 | 只看规模的命令 | 排查时容易误会的地方 |
|---|---|---|
| string | STRLEN 键名 | 里面即使是 JSON 文本,Redis 类型仍是字符串;不能直接用哈希命令读取字段。 |
| hash | HLEN 键名 | 这是字段集合,GET 整个键不适用;确认业务字段后才考虑对应字段读取。 |
| list | LLEN 键名 | 这是有序列表,读取与消费是不同动作,不要用出队命令查看内容。 |
按已经确认的类型只选择一条对应命令,不把整张表的命令全部试一遍。返回长度或数量可以帮助确认对象规模,无需先把缓存内容完整导出。若错误来自 JSON、HyperLogLog 等特定命令,还要核对该功能要求的格式;TYPE=string 并不能证明它是有效的 HyperLogLog。
修复写入约定,比清空旧键更重要
命令用错:先确认这个键按业务设计应是什么类型,再修改调用代码。不能看到 hash 就机械地把所有 GET 换成 HGET,因为后者还需要明确字段,返回结果结构也不同。
多个功能撞了同一个名字:在代码和配置中查找完整前缀,确认哪些进程会创建、更新该键。给用途不同的数据安排独立名称,比如用户资料、队列与页面缓存分别使用自己的前缀。尤其注意普通 SET 可以覆盖原有类型,后来的一次写入可能改变此前正常的键。
新旧程序结构不同:设计带版本的新键名,在测试环境验证转换及新旧版本并行期间的读写规则。保留旧数据,核对到期时间、序列化格式和业务含义;不要把快到期的数据重新延长一整个缓存周期。队列、锁、会话等数据不能按普通可再生成缓存处理。
修改发布后要核对所有应用实例、任务进程和定时脚本。只更新一台网站进程,旧任务仍可能继续写入冲突类型。连接与认证检查可参考Redis安装、访问控制与连接验证。
出现事务错误时,先核对已经发生的结果
如果 WRONGTYPE 出现在 MULTI / EXEC 执行阶段,不能认为整个事务已回滚。某条命令执行时报错后,其他已入队命令仍会执行。应用应检查每条返回值和实际业务记录,不能整批重试,以免重复递增、重复入队或重复处理订单。
验收从原来失败的业务路径开始:确认修正后的完整键名和类型,观察写入后读取是否符合预期、TTL 是否正确,核对日志中错误不再出现。涉及真实写操作时先用隔离测试数据验证,再按已确认的发布流程应用变更。
如果过一段时间又变成另一类型,回到写入来源继续找冲突,不靠定时清理键来维持表面正常。保留这次确认的前缀、类型与维护程序清单,后续升级时一起检查。