Redis 执行 KEYS * 报 ERR timeout 超时 怎么用 SCAN 游标遍历不阻塞主线程

现象:Redis 执行 KEYS * 报 ERR timeout

上线后偶尔监控告警 Redis 主线程阻塞超过 1 秒,排查发现某个定时任务用 KEYS * 扫描所有 key,key 数量上了 10 万后 KEYS 是 O(N) 全量扫描,直接把主线程卡住了。客户端那边就报 ERR timeout,连接池里的请求全排队等待。

根因:KEYS 是 O(N) 全量扫描,会阻塞主线程

Redis 单线程模型下,KEYS 要遍历整个 keyspace 才能返回结果。数据量小时没问题,key 上了几万就开始卡,上了 10 万+ 主线程阻塞几秒,所有其他命令都排队。Redis 官方文档也明确说 KEYS 只能在测试环境或小数据库用,生产环境禁止。

# 生产禁止!O(N) 阻塞主线程
redis-cli KEYS "*"

# 正确写法:SCAN 游标遍历,O(1) 每次调用
redis-cli SCAN 0
# 返回: 1) "4096"  下一次游标
#       2) 1) "key1" 2) "key2" 3) "key3"

SCAN 的三个参数

SCAN 第一个参数是游标,第一次传 0,返回的第一个元素就是下一次的游标。MATCH 过滤模式,COUNT 建议值(不是精确返回数量)。SCAN 是增量迭代,每次只扫部分 key,不会阻塞主线程。

# Python 里用 SCAN 替代 KEYS
import redis
r = redis.Redis()
cursor = 0
keys = []
while True:
    cursor, batch = r.scan(cursor=cursor, match='user:*', count=500)
    keys.extend(batch)
    if cursor == 0:
        break
print(f"共 {len(keys)} 个 user:* key")

其他相关命令也有安全替代

SMEMBERS 改成 SSCAN、hGetAll 改成 HSCAN、ZRANGE 改成 ZSCAN,所有集合类型都有对应的增量遍历命令。记住一个原则:任何需要遍历全量数据的命令(KEYS、SMEMBERS、HGETALL)在生产环境都要警惕,先看 Redis 文档里有没有增量版本。

总结:Redis KEYS * 阻塞主线程报 timeout,生产环境绝对禁止。用 SCAN 增量遍历,每次只扫部分 key,完全不阻塞主线程。Python/Go/Node 客户端都有 scan 方法,用法和 KEYS 差不多但安全得多。

您可以还会对下面的文章感兴趣: