异常教程

redis 查询所有key（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在现代应用开发中，Redis 作为高性能的内存数据库，因其快速读写能力和丰富的数据结构支持，被广泛应用于缓存、队列、计数器等场景。然而，随着数据量的增长，开发者常常需要解决一个基础但关键的问题：如何查询 Redis 中存储的所有 Key？这个问题看似简单，但深入实践时会涉及性能优化、命令选择和安全风险等复杂因素。本文将从 Redis 的核心概念出发，逐步解析查询所有 Key 的方法，并通过案例演示和代码示例，帮助读者掌握这一技能。

Redis 的基础概念：理解 Key 的存储逻辑

Key-Value 存储模型

Redis 是典型的 Key-Value 数据库，所有数据都以键（Key）和值（Value）的形式存储。每个 Key 是唯一的标识符，而 Value 可以是字符串、列表、哈希表、集合等数据类型。例如，一个电商系统可能将用户会话信息存储为 session:12345，将商品库存信息存储为 stock:product_678。

数据库分片与命名空间

Redis 默认支持 16 个数据库（db 0 到 db 15），但实际开发中更倾向于使用 命名空间（Namespace）来管理 Key。命名空间通过在 Key 前添加前缀（如 user:, cache:）实现逻辑隔离。例如：

user:1001:profile  
cache:product:678:price

这种设计既能避免 Key 冲突，也便于批量操作（如查询某类 Key）。

查询所有 Key 的方法：命令详解与对比

方法 1：KEYS 命令——简单直接但需谨慎

KEYS 是 Redis 提供的最直接查询所有 Key 的命令，语法如下：

KEYS *

此命令会返回所有匹配通配符 * 的 Key。例如：

127.0.0.1:6379> KEYS *  
1) "user:1001:profile"  
2) "cache:product:678:price"

注意事项：

  • 阻塞风险：当数据量较大时，KEYS 会遍历所有数据库，导致 Redis 进程阻塞，影响其他操作。
  • 适用场景：仅限于测试环境或数据量极小的生产环境。

方法 2：SCAN 命令——渐进式扫描的优雅方案

为解决 KEYS 的阻塞问题，Redis 2.8 引入了 SCAN 命令，通过分步扫描避免阻塞。其核心机制类似“图书馆逐页翻书”：

SCAN cursor [MATCH pattern] [COUNT count]
  • cursor：起始位置（初始值为 0，后续由 Redis 返回）。
  • MATCH：可选参数，用于过滤 Key（如 MATCH user:*）。
  • COUNT：建议扫描的 Key 数量（默认为 10，但实际可能更多）。

示例代码：

import redis  

r = redis.Redis(host='localhost', port=6379, db=0)  
cursor = '0'  
while cursor != 0:  
    cursor, keys = r.scan(cursor=cursor, match='user:*', count=100)  
    for key in keys:  
        print(key.decode('utf-8'))

此代码通过循环遍历所有 user:* 类型的 Key，避免了单次阻塞。

方法 3：结合正则表达式与 KEYS 的筛选

若需按特定模式查询 Key，可结合 KEYS 和正则表达式：

KEYS user:*:profile

此命令会返回所有符合 user:*:profile 的 Key（如 user:1001:profile）。但需注意，正则表达式仍可能触发阻塞，需谨慎使用。

方法 4：使用 Redis 工具辅助查询

Redis Desktop Manager（图形化工具）

通过安装 Redis 桌面管理工具（Redis Desktop Manager ），用户可直观查看所有 Key，并支持过滤和排序。

redis-cli 命令行工具

直接在命令行中执行 redis-cli keys '*' 即可查看所有 Key。

关键知识点：性能与安全的平衡

为什么 KEYS 在生产环境不可取？

假设一个 Redis 实例存储了 100 万个 Key，执行 KEYS * 会：

  1. 一次性加载所有 Key 到内存，可能引发内存溢出。
  2. 阻塞 Redis 线程，导致其他客户端请求超时。

如何安全地查询 Key？

  • 使用 SCAN 命令：分批次处理，避免阻塞。
  • 限制数据库分片：将不同业务数据分散到不同 db 中，缩小查询范围。
  • 命名规范：通过命名空间（如 cache_2023）缩小 SCAN 的匹配范围。

实战案例：电商系统的 Key 管理

案例背景

某电商平台需监控所有库存 Key（如 stock:product_678），并清理过期 Key。

解决方案

  1. 查询所有库存 Key： 
    SCAN 0 MATCH stock:* COUNT 1000
  2. 删除过期 Key：结合 EXPIRE 和 SCAN 实现自动化清理。

代码示例（Python）：

while True:  
    cursor, keys = r.scan(cursor=0, match='stock:*', count=1000)  
    for key in keys:  
        # 假设过期时间为 3600 秒  
        if r.ttl(key) < 0:  
            r.delete(key)  
    if cursor == 0:  
        break

常见问题与解答

Q: 如何快速清空所有 Key？

A: 使用 FLUSHALL 命令，但需谨慎操作！

FLUSHALL

Q: SCAN 是否保证返回所有 Key？

A: SCAN 的概率性算法会覆盖所有 Key，但可能因并发写入导致重复或遗漏，需结合业务逻辑处理。

结论

查询 Redis 的所有 Key 是开发者必须掌握的基础技能，但其背后涉及性能、安全和设计模式的考量。通过本文的分析，读者应能：

  1. 理解 KEYS 和 SCAN 的适用场景与风险。
  2. 使用 SCAN 命令实现高效、安全的 Key 管理。
  3. 结合命名空间和工具提升开发效率。

掌握这些知识后，开发者不仅能解决基础问题，还能为构建高可用、高性能的 Redis 应用打下坚实基础。

关键词布局检查：

  • 标题：包含“redis 查询所有key”
  • 正文：通过命令对比、案例等自然提及关键词
  • 结论：总结关键词的应用场景

本文通过循序渐进的讲解和代码示例，帮助读者在理解 Redis 核心机制的同时，掌握实际问题的解决方案。

最新发布

查看更多文章