Redis MEMORY USAGE 的 samples 参数怎样估算集合内存

如果你用 MEMORY USAGE 检查一个 Hash、List、Set 或 ZSet，真正需要判断的不是“SAMPLES 越大越好吗”，而是集合成员大小是否均匀，以及这次查询能承受多少遍历成本。Redis 文档中的默认值是 SAMPLES 5；SAMPLES 0 表示采样全部嵌套值。小样本适合巡检，全量采样适合对关键大 key 做基准核对。

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

SAMPLES 到底采样了什么

MEMORY USAGE key [SAMPLES count] 报告的是某个 key 及其 value 在内存中占用的字节数。对于嵌套数据类型，Redis 会抽取指定数量的成员，依据样本的平均大小估算整个集合的成员部分，再加上数据结构本身的固定开销。

可以把它理解成一个近似关系：

# 这是解释估算思路的近似式，不是 Redis 对外承诺的内部实现公式
估算内存 ≈ key 与容器固定开销 + 平均成员开销 × 集合成员总数

因此，SAMPLES 5 并不是只计算前五个元素，也不表示结果只有五分之一精度。它告诉 Redis 用五个嵌套成员来推断其余成员。字符串这类没有嵌套成员的简单值，SAMPLES 没有可采样的集合成员；真正需要关注它的场景是聚合类型。

先用同一个 key 对比样本数

排查大 key 时，建议固定 key 不变，只改变样本数。下面的命令适合在测试环境或低峰期做对照：

# 先看默认样本数对应的快速估算
redis-cli MEMORY USAGE user:1001:cart

# 增加样本，观察成员大小差异是否让结果发生明显变化
redis-cli MEMORY USAGE user:1001:cart SAMPLES 50
redis-cli MEMORY USAGE user:1001:cart SAMPLES 200

# 对关键集合做全量采样，作为一次基准对照
redis-cli MEMORY USAGE user:1001:cart SAMPLES 0

命令复杂度随样本数增加，官方文档将其描述为 O(N)，其中 N 是样本数。SAMPLES 0 会查看全部嵌套成员，集合很大时不应在高峰期对大量 key 批量执行。

怎样判断一次估算是否可信

如果集合成员大小分布比较均匀，SAMPLES 5、50 和 200 的结果通常会比较接近；如果集合里同时存在很短和很长的成员，小样本就可能受到抽样构成影响。这里的“可信”不是看一个绝对阈值，而是看样本数变化后结果是否稳定。

可以记录一组简单的排查表：

• key 类型是什么，是否包含嵌套成员；
• 默认样本与较大样本的差值有多大；
• 集合是否正在持续写入，采样期间数据是否变化；
• 结果是否只用于排序大 key，还是要支撑扩容和拆分决定。

不要把单个 key 的结果直接加总成实例内存。Redis 的全局内存还要看客户端、复制、持久化、碎片和其他内部开销；需要看整体时，应把单 key 分析与 INFO memory 或 MEMORY STATS 的全局指标并列解读。

常见问题

SAMPLES 5 是不是只统计五个元素？

不是。它抽取五个嵌套成员来估计整个集合，结果仍然试图覆盖整个 value，并包含相关固定开销。

SAMPLES 0 一定比 SAMPLES 200 更适合线上吗？

不一定。它的参照更完整，但遍历成本也更高。线上巡检通常先用小样本定位，再对少量关键 key 在低峰期做全量对照。

为什么两次 MEMORY USAGE 结果会变化？

除了采样差异，集合可能正在变化，成员大小也可能不均匀；同时内存分配器和数据结构开销会让结果不等于业务字段长度。