Redis OBJECT IDLETIME 怎样查看对象空闲时长

执行 OBJECT IDLETIME key，可以查看键值对象距上次访问的大致空闲秒数。键不存在时返回空值；使用LFU内存淘汰策略时，该指标不可用。它不是TTL，不是键的创建时间，也不是业务用户最后操作时间的审计记录。

如果目标是判断某个缓存是否近期被访问，先取空闲时间，再决定是否需要读取值。反过来先GET确认内容，可能已经改变了要观察的访问元信息。下面按“旧判断哪里不够—命令表达什么—怎样取值”的顺序解释，这是对已有命令语义的梳理，并非某次Redis版本新增能力。

Redis官方文档地址：https://redis.io/docs/latest/commands/object-idletime/

先把空闲时间和剩余寿命分开

TTL回答离过期还有多久；OBJECT IDLETIME回答对象多久没有被访问。Redis键同时可能具有访问元信息与过期元信息，但两者用途不同：有过期时间的键也可能长期空闲，没有设置过期时间的键也可能持续被读取。

TTL官方返回值说明列出了负值含义。不要把TTL的-1、-2套用到IDLETIME：后者找不到键时是空值，客户端通常解码为nil或null。

最小用法：直接读取目标键的元信息

以下命令在系统终端调用redis-cli，使用现有连接方式。例子按本地默认实例与数据库0编写，连接其他实例时应使用自己的连接配置，不把凭据写进脚本或文章。

# 只查询键对象的空闲秒数，不读取业务值
redis-cli -n 0 OBJECT IDLETIME 'cache:catalog:summary'

整数0仍然是有效观测，不能当成“键不存在”。假设返回300，可以理解为这次观测时对象大约空闲300秒；它不是一个精确的墙上时钟时间戳。当前官方命令文档给出的复杂度为O(1)，但采样大量键仍会增加命令数与网络往返。依据：OBJECT IDLETIME命令语义及回复类型。

返回空值时，先检查目标实例、数据库和完整键名；键也可能在查询前过期或被删除。不要仅凭空值推断“从未访问”。若返回权限错误，则处理连接身份与授权范围，不能把权限失败记作0秒。

用隔离测试键比较访问前后

下面是给读者在测试实例执行的示例。它只创建一个带短期过期时间的独立测试键，不改淘汰策略。设置使用NX，避免覆盖同名数据；若返回不是OK，应换一个未使用的测试键，再进行后面的观察。

# 先确认实例当前策略；此查询需要相应权限
redis-cli CONFIG GET maxmemory-policy
# 仅在非LFU测试实例继续；NX确保不覆盖已存在的同名键
redis-cli SET 'demo:idletime:sample' 'example' NX EX 120
# 等待只用于示例观察，不代表秒级结果必须精确相等
sleep 4
redis-cli OBJECT IDLETIME 'demo:idletime:sample'
# GET读取测试字符串，通常会更新访问元信息
redis-cli GET 'demo:idletime:sample'
redis-cli OBJECT IDLETIME 'demo:idletime:sample'

在普通、会跟踪访问的测试条件下，第一次空闲读数应比刚GET后的读数大，后者通常接近0；具体数字受时钟粒度、调度和其他访问影响。这是预期现象，本文没有实际执行这些命令。测试键会按设置的期限过期，无需为了看空闲时间去修改生产数据。

重复查询OBJECT IDLETIME自身不会像普通GET那样刷新对象的LRU访问元信息。当前项目实现为OBJECT查询使用不触碰访问状态的查找标志，所以采集时不要额外加一个GET作为“存在性确认”。这是实现层依据，不应扩大成所有只读命令都不会影响空闲值。依据：Redis对象查询实现中的LOOKUP_NOTOUCH。

LFU策略下为什么不能使用IDLETIME

maxmemory-policy 决定对象维护的淘汰相关信息。非LFU策略下可以使用OBJECT IDLETIME观测近似空闲秒数；LFU策略如 allkeys-lfu 或 volatile-lfu 使用频次相关元信息，IDLETIME会报不支持。不要仅仅为了跑通查询就在生产实例切换策略。

# 读取有效配置而非改变配置；托管服务可能限制此命令
redis-cli CONFIG GET maxmemory-policy
# 仅当实例为LFU策略、且需要观察频次时使用
redis-cli OBJECT FREQ 'cache:catalog:summary'

OBJECT FREQ返回的是对数型访问频次计数器，不是访问总次数，更不能换算成空闲秒数。FREQ官方说明与CONFIG GET配置查询说明可用于核对。若平台不允许读取配置，应通过平台提供的配置视图或管理员确认。

怎样把观测结果用于缓存判断

可以把一次空闲读数当作排查线索，与业务访问日志和缓存用途一起分析。不要写成“空闲超过阈值就一定可删”：定时任务、低频关键查询或业务季节性都可能让有用的键长时间不被访问。

如果业务需要精确的最近访问事件，应在应用层定义何时记录、如何保存和怎样处理失败。对象的近似访问元信息只服务于当前实例的内部观测，不构成跨重建、迁移和生命周期变化的业务历史保证。

常见问题

返回很大，是否说明这个键快过期？

不能。空闲时长与过期时间是两种信息，剩余寿命用TTL单独看。

没有设置maxmemory，是否就不能查？

官方限制关注maxmemory-policy是否为LFU，不是仅由maxmemory数值决定。先核对有效策略和命令是否被平台支持。

每次读数都很小怎么办？

先看是否有应用、探针或自己的GET在读这个键。把元信息查询与值读取分开，避免观察动作改变被观察对象的访问状态。