Redis OBJECT HELP命令查看Key的空闲时间与引用计数

打开终端或命令行工具，确保 Redis 服务已处于运行状态。

1. 连接数据库并查看帮助

输入以下命令连接到本地 Redis 服务（默认端口 6379）：

redis-cli

连接成功后，输入 OBJECT HELP 命令并按下回车键。此命令用于列出 OBJECT 命令支持的所有子命令，便于快速查阅可用功能。

终端将输出如下列表：

 1. <key> REFCOUNT <key>      返回该 Key 被引用的数量
 2. <key> ENCODING <key>      返回该 Key 内部存储的编码形式
 3. <key> IDLETIME <key>      返回该 Key 自从最后一次被读取以来的空闲秒数
 4. <key> FREQ <key>          返回该 Key 的访问频率（LFU 策略相关）

2. 准备测试数据

为了演示引用计数和空闲时间的变化，需要先在数据库中创建一个 Key。

执行以下命令设置一个字符串类型的 Key：

SET user:1001 "zhangsan"

3. 查看引用计数 (REFCOUNT)

Redis 内部通过引用计数来管理内存对象的生命周期。执行以下命令查看 user:1001 的引用计数：

OBJECT REFCOUNT user:1001

终端将返回一个整数，通常是 1。这表示当前只有一个数据库指针指向该对象。当引用计数降为 0 时，Redis 会释放该对象占用的内存。

4. 查看空闲时间 (IDLETIME)

空闲时间指自最后一次对该 Key 进行读取或写入操作以来经过的秒数。此参数对于 Redis 的内存淘汰策略（如 volatile-lru 或 allkeys-lru）至关重要。

执行以下命令查看当前 Key 的空闲时间：

OBJECT IDLETIME user:1001

由于刚刚执行了 SET 操作，终端返回的值极小，通常是 0。

等待 5 秒钟。

再次执行上述命令：

OBJECT IDLETIME user:1001

此时终端返回的数值应接近 5（或略大，取决于操作间隔）。

执行读取操作以重置空闲时间：

GET user:1001

立即执行 OBJECT IDLETIME user:1001，观察数值是否重新变为 0。

5. 理解空闲时间与引用计数的关系

为了更直观地理解操作对这两个指标的影响，下图展示了 Key 在被访问和闲置过程中，引用计数保持不变而空闲时间重置的逻辑流程。

6. 命令参数汇总

下表总结了 OBJECT 命令中涉及查看属性的核心子命令及其返回值类型。

7. 进阶测试：多引用场景

当 Key 被多个数据结构引用时，引用计数会发生变化。执行以下命令创建一个列表并推入上述 Key（注意：Redis 的 OBJECT REFCOUNT 通常针对值对象，此处演示概念，实际上直接针对 Key 查询通常返回 1，除非在特定内部结构引用中。更准确的多引用测试通常涉及 Lua 脚本或内部结构，但普通 Key 的 REFCOUNT 一般为 1）。

验证基础 Key 的独立性：

EXISTS user:1001

返回 1 表示 Key 存在。对于普通数据库 Key，REFCOUNT 通常维持在 1，直到 Key 被 DEL 删除。

执行删除操作：

DEL user:1001

再次执行 OBJECT REFCOUNT user:1001，终端将报错，提示 Key 不存在。