Redis OBJECT FREQ 怎样读取LFU访问频率计数

排查 Redis LFU 缓存时，最容易误解的是把访问频率当成精确请求总数。OBJECT FREQ key 读取的是 Redis 为对象维护的对数访问频率计数；它只在实例使用 LFU 淘汰策略时可用，适合判断冷热程度，不适合做计费或审计凭据。

官方地址：https://redis.io/docs/latest/commands/object-freq/

下面按“配置是否匹配、key 是否存在、返回值是什么、业务能否使用”四层排查。这样遇到命令不可用、返回空值或计数变化不符合预期时，不会把不同问题混在一起。

先确认 OBJECT FREQ 的适用条件

第一步不是直接执行命令，而是确认 maxmemory-policy。Redis 官方文档说明，OBJECT FREQ 只有在策略设为 allkeys-lfu 或 volatile-lfu 等 LFU 策略时才可用；如果仍是 LRU、随机淘汰或 noeviction，就不能把它当作普通的访问统计接口。

# 查看当前淘汰策略，先确认实例是否处于 LFU 模式
redis-cli CONFIG GET maxmemory-policy

# 只有在明确把实例用于 LFU 缓存时才修改配置
redis-cli CONFIG SET maxmemory-policy allkeys-lfu

如果生产环境通过配置文件、云控制台或托管参数管理策略，应在对应配置源中修改并记录变更，不要只在一次临时会话里设置。volatile-lfu 只把带过期时间的 key 纳入 LFU 淘汰范围，排查时要额外确认目标 key 是否设置了 TTL。

用最小命令读取计数

条件确认后，命令格式只有一个 key：

# 读取指定缓存对象的 LFU 访问频率计数
redis-cli OBJECT FREQ user:1001:profile

key 存在时，Redis 返回一个整数；key 不存在时，RESP2 表现为空值（nil），RESP3 表现为 null。空值不等于“访问次数为 0”，而是说明当前没有这个对象可以读取，常见原因包括过期、被淘汰、被删除，或者连接到了错误的数据库编号。

为了把“key 不存在”和“命令返回异常”分开，可以先查存在性，再读取计数：

# 先确认 key 是否仍在当前数据库中
redis-cli EXISTS user:1001:profile

# key 存在后再读取近似频率；不要把空值转换成数字 0
redis-cli OBJECT FREQ user:1001:profile

不要把频率计数当作精确访问次数

Redis 文档把这个值定义为 logarithmic access frequency counter，也就是对数访问频率计数。Redis 的 LFU 机制使用近似计数，让每个对象只占用很少的额外空间，并结合衰减时间适应访问模式变化。因此，两个 key 的计数可以帮助判断相对冷热，但不能推出“这个 key 被读取了多少次”的精确答案。

按排查顺序定位异常

当结果和预期不一致时，建议固定下面的检查顺序：

1. 查策略：用 CONFIG GET maxmemory-policy 确认是否为 LFU；托管 Redis 则查实际生效的实例参数。
2. 查 key 生命周期：用 EXISTS 和 TTL 判断 key 是否过期；在 volatile-lfu 下还要确认它确实属于带 TTL 的候选对象。
3. 查连接上下文：确认 host、端口、认证账号和 SELECT 的数据库编号，避免在另一套实例或另一数据库上读取。
4. 查返回协议：客户端应分别处理整数、nil/null 与命令错误，不要把所有非整数结果都转成 0。
5. 查业务边界：如果需求是精确统计请求量，应使用应用层计数、日志或指标系统；OBJECT FREQ 只回答“这个 Redis 对象的 LFU 热度信号是什么”。

最后可以把排查结果记录成三类：策略不匹配、对象不存在、对象存在且返回近似计数。这个分类比单独保存一个频率数字更有用，因为它保留了配置和生命周期上下文。

常见问题

OBJECT FREQ 返回 0 是不是 key 从未被访问？

不能这样推断。返回值是近似的对数计数，应该结合 key 是否存在、实例 LFU 配置和采样时间解读；如果需要精确次数，应另建计数指标。

为什么 key 明明存在却无法读取频率？

先确认连接到同一个实例和数据库，再检查实际生效的 maxmemory-policy。在非 LFU 策略下，OBJECT FREQ 的前置条件不成立；在带 TTL 的 LFU 策略下，还要确认 key 的生命周期符合缓存策略。

总结

读取 Redis LFU 访问频率的最小命令是 OBJECT FREQ key，但正确使用它要先确认 LFU 策略，再区分整数与空值，最后把结果当作近似冷热信号。只要不把它误当作精确计数器，排查缓存淘汰和热点 key 时就能得到更可靠的判断。