Redis 怎样估算一个键的内存占用

Redis 里想知道一个键到底占了多少内存，直接使用 MEMORY USAGE。它返回的是这个键和值在 Redis RAM 中需要的字节数，结果包含数据本身以及维护数据结构所需的管理开销。遇到 Hash、List、Set 等带嵌套元素的聚合类型时，再用 SAMPLES 控制抽样范围。

官方地址：https://redis.io/docs/latest/commands/memory-usage/

最实用的判断方式是：单值键直接测量；聚合键先接受默认 5 个样本的估算，键规模较小或需要更精确时指定样本数，确实要遍历全部嵌套值时使用 SAMPLES 0。返回值是单键的内存估算，不等于整个 Redis 实例的 RSS。

MEMORY USAGE 测量的到底是什么

这条命令的变化点不在于“把字符串长度换算成字节”，而在于它把一个键在 Redis 内部占用的内存作为整体返回。这个整体包含键和值对应的数据分配，也包含管理这些对象所需的额外开销，所以命令结果通常不会等于业务字符串或 JSON 文本的字符数。

这也是容量排查时最容易误读的地方：结果适合回答“这个键大约占多少 RAM”，不适合直接回答“整个实例还剩多少内存”。实例级容量、碎片和多个键的总量需要另外观察；本文只围绕单键测量和聚合值抽样。

先测量字符串等单值键

字符串键没有需要逐个遍历的嵌套成员，可以从最短命令开始。下面的命令使用临时键演示查询方式，注释只说明每段命令的目的：

# 写入一个短字符串，准备一个可重复查询的键
redis-cli SET demo:user:1 "hello-redis"

# 读取这个键及其值在 Redis RAM 中的字节数
redis-cli MEMORY USAGE demo:user:1

# 查询不存在的键，用于识别空返回而不是把它当成 0 字节
redis-cli MEMORY USAGE demo:user:not-found

正常存在的键会返回整数，单位是字节；不存在的键会返回 nil 或 null，具体表现取决于 RESP2 或 RESP3。不要把空返回写成“Redis 认为它占 0 字节”，因为这里代表的是查询对象不存在。

同样的命令也能用于 Hash、List、Set 和 Sorted Set，但聚合类型会进入下一层的采样规则。命令本身从 Redis Open Source 4.0.0 开始提供，官方文档标注的时间复杂度为 O(N)，其中 N 是样本数。

聚合类型怎样选择 SAMPLES

聚合类型内部包含多个嵌套值。MEMORY USAGE key 不写参数时，SAMPLES 默认是 5：Redis 从嵌套值中取样，再用样本的平均占用估算整体大小。这个默认值适合先筛查一批键，但它不是“永远只计算五个成员的总和”。

需要控制抽样规模时，把样本数写在命令后面：

# 创建一个小 Hash，字段数量用于演示嵌套值
redis-cli HSET demo:profile name "Lin" city "Hangzhou" level "3"

# 不写 SAMPLES 时使用 Redis 文档定义的默认样本数 5
redis-cli MEMORY USAGE demo:profile

# 指定抽样数量，用于在成本和估算稳定性之间做取舍
redis-cli MEMORY USAGE demo:profile SAMPLES 10

# 采样全部嵌套值，适合规模可控且需要完整测量的键
redis-cli MEMORY USAGE demo:profile SAMPLES 0

SAMPLES 0 的含义是采样全部嵌套值，不是关闭内存统计。对于成员很多的聚合键，样本数越大，命令需要处理的嵌套值也越多；官方文档将复杂度写成与样本数相关的 O(N)，因此不要把全量采样当成大键巡检的默认动作。

从默认采样到全量测量，怎么做选择

可以把采样选择理解为三个层次，而不是简单地认为数字越大越好：

如果你是在排查“某个业务对象为什么突然变大”，可以先用默认采样确认量级，再针对少量候选键增加样本数。这样能把一次容量判断拆成筛查和复查两个动作，避免在还没有候选范围时对大量大聚合键做全量测量。

最小复查：四个结果都要记下来

一次可复用的单键内存记录，至少保留键的数据类型、嵌套规模、命令参数和返回状态。下面这份清单不需要执行本地代码，只是为了让排查结果可解释：

键名：demo:profile
数据类型：Hash
测量参数：SAMPLES 10
返回单位：字节
返回状态：整数；不存在键时记录为 nil/null
解释边界：包含数据分配和管理开销，不代表整个实例 RSS

最小验证的重点不是追求一个永远不变的数字，而是确认测量口径没有混淆：同一键是否用了相同的 SAMPLES，结果是否带单位，是否把不存在键和零字节区分开，是否把单键结果错误外推成实例总内存。

常见问题

MEMORY USAGE 返回的就是字符串长度吗？

不是。返回值包含数据分配和管理开销；短字符串也可能有明显的结构性开销，所以不能只按字符数估算。

为什么同一个 Hash 不指定 SAMPLES 也能返回一个总大小？

因为聚合类型默认使用 5 个嵌套样本，并用样本平均值估算整体大小。它是为了降低测量成本的估算机制，不是只把五个字段相加。

什么时候应该使用 SAMPLES 0？

当目标键的嵌套规模可控，并且你确实需要遍历全部嵌套值时使用。对大型键或批量排查，先用默认采样缩小范围通常更稳妥。

总结

Redis 估算单键内存的入口就是 MEMORY USAGE：单值键直接读取；聚合类型默认采样 5 个嵌套值，需要更充分的估算时指定 SAMPLES count，需要完整遍历时使用 SAMPLES 0。最后记住三个边界：返回单位是字节，结果包含管理开销，不存在的键返回 nil/null；它描述的是一个键，不是整个实例。