Redis MEMORY USAGE命令精确计算Key的内存占用

在性能调优或成本分析过程中，准确掌握单个 Key 的内存消耗是排查“大 Key”问题的核心能力。Redis 提供的 MEMORY USAGE 命令能够直接返回 Key 在内存中占用的字节数，无需依赖估算或第三方工具。

一、 基础操作：快速查看单个 Key 内存

1. 打开 终端或命令行工具。

2. 连接 目标 Redis 实例，执行 redis-cli 登录命令。

3. 运行 以下命令查看指定 Key 的内存占用：

   MEMORY USAGE your_key_name

4. 查看 返回结果。结果为整数，代表字节数。若返回 (nil)，则表示 Key 不存在。

查看 以下返回值示例解读：

二、 进阶操作：理解采样与精确度

对于 String 类型，MEMORY USAGE 返回的结果是完全精确的。但对于 Hash、Set、List 等集合类型，为了避免计算大集合时阻塞主线程，Redis 默认采用“采样估算”算法。

1. 理解采样原理

默认情况下，命令的 SAMPLES 参数值为 5。这意味着对于包含 10,000 个元素的 Set 集合，Redis 仅随机抽取 5 个元素计算平均大小，再乘以总数量得出结果。如果元素大小差异巨大，结果会产生偏差。

2. 提升计算精确度

若需对复杂集合进行精确计算，必须手动调高 采样数量。

1. 确认 目标 Key 的类型（使用 TYPE key 命令）。

2. 若为集合类型，执行 指定采样数的命令：

   MEMORY USAGE my_big_set SAMPLES 1000

3. 对比 不同采样数下的结果。若采样数接近或等于集合总长度，结果将趋近于精确值，但计算耗时会相应增加。

三、 内存计算逻辑解析

Redis 存储 Key-Value 时，内存占用不仅包含数据本身，还包含 RedisObject 结构头、编码方式带来的额外指针开销以及 Key 的字符串长度开销。

参考 以下内存计算逻辑流程：

四、 批量排查：定位占用内存最高的 Key

Redis 原生命令不支持直接批量输出所有 Key 的内存并排序。需结合 Shell 脚本通过管道操作实现自动化排查。

1. 创建 脚本文件 scan_big_keys.sh。

2. 复制 以下代码内容到脚本中：

   #!/bin/bash
   # 定义Redis连接信息
   REDIS_CLI="redis-cli -h 127.0.0.1 -p 6379"
   
   # 使用 SCAN 遍历 Key (避免使用 KEYS * 阻塞服务)
   $REDIS_CLI SCAN 0 MATCH "*" COUNT 1000 | tail -n +2 | while read key; do
           # 获取内存字节数
           size=$($REDIS_CLI MEMORY USAGE "$key")
       # 输出 "内存大小 Key名称"
       echo -e "$size\t$key"
   done | sort -nr | head -n 20

3. 保存 文件并赋予 执行权限：

   chmod +x scan_big_keys.sh

4. 运行 脚本：

   ./scan_big_keys.sh

5. 分析 输出列表。列表将按内存占用从大到小排列前 20 个 Key。

五、 关键注意事项

1. 区分 数据大小与内存占用。MEMORY USAGE 返回值通常大于原始数据大小，因为其包含了 Redis 维护数据结构所需的指针、引用计数等元数据。
2. 警惕 阻塞风险。对包含数万元素的 Key 设置过高的 SAMPLES 值（如 10000）会消耗大量 CPU 并阻塞 Redis 主线程，建议在从节点或低峰期执行。
3. 注意 编码差异。同一类型的 Key 在元素数量变化时可能触发编码转换（如 Hash 结构从 listpack 转为 hashtable），导致内存占用发生跳跃式变化。