Redis查找大量键:SCAN怎么用才不会漏看结果

适用范围:Redis键空间查询;先确认逻辑数据库与实例,扫描仍需控制频率。

只想找某一类缓存键,却在高峰执行KEYS匹配整个库,可能影响正常请求。SCAN可以把遍历拆成多次,但它不是数据库快照,也不是“每次固定返回多少条”的分页接口。[1]

用游标继续,而不是反复从0开始

在正确实例和数据库中执行:

SCAN 0 MATCH app:cache:* COUNT 100

响应包含下一次游标和本次键列表。将实际返回的游标原样用于下一次调用;一直继续到返回游标为0,才完成这一轮遍历。不要把示例数字当成可固定递增的页码。

COUNT是工作量提示,不是精确页大小;某次键列表为空,只要游标还不为0,就不能停止。[1]

如何解释重复和变化

完整扫描期间一直存在的键有相应遍历保证,但同一个键可能多次返回。对扫描期间新增、删除、过期的键,结果不是一致快照。要做计数需去重,并说明是在变化中的库上估算,不能用于精确对账。

只需要观察前几十个匹配键时,可以主动停止,明确把结果称为样本;不能据此得出“总共只有这些键”。

控制每次负载和结果暴露

从较小COUNT开始,观察延迟再调整,调用之间适当间隔。扫描键名后再查内容,应按类型选择读取方法并限制返回量。不要无差别GET所有键,也不要把session、token等敏感键及内容贴进截图。

即使键名看起来只是缓存,也不要直接把扫描输出接到删除命令。至少要先保存匹配范围、确认业务归属和保留策略,删除需另行审核。

多实例与Cluster不能当成单一库

一个节点上的SCAN不天然等于全体集群所有键。要按实际拓扑和客户端能力遍历对应主节点,并考虑迁移、重分片期间的重复与变化。[1][2]

非集群环境还应确认数据库编号,避免默认连0号库却以为业务键全部丢失。SCAN只负责发现键,不验证复制一致性或备份可恢复性。

完成检查

记录开始与结束时间、库编号、节点范围、最终游标、是否去重。操作结束确认业务延迟没有持续恶化。需要准确清点或迁移时,应另行制定一致性方案,而不是把线上SCAN结果直接当作完整备份。

继续排查

Redis内存满了:查占用与设置淘汰策略;Redis报WRONGTYPE:先查键类型。

技术依据:[1] Redis SCAN语义及游标保证;[2] Redis集群规范。适用版本见本文说明。