zset-max-ziplist-value 控制 ZSet 中每个 member 和 score 的最大字节长度,超限即退化为 skiplist+dict;它比 entries 更易踩坑,因 score 和 member 字符串长度易超默认 64 字节,导致编码失效。

zset-max-ziplist-value 控制的是 ZSet 中每个 member 和每个 score 的最大字节长度,不是总长度,也不是 UTF-8 字符数 —— 超过它,哪怕只超 1 字节,ZSet 就会退化为 skiplist+dict 双结构,内存可能翻倍。
为什么 zset-max-ziplist-value 比 entries 更容易踩坑
很多人调高 zset-max-ziplist-entries 却忽略 zset-max-ziplist-value,结果 ZSet 还是没走 ziplist。原因很直接:
- score 在 Redis 内部以字符串形式存储(比如
"1672531200"占 10 字节,"9223372036854775807"占 19 字节) - member 若是 UUID、带前缀的 ID 或 JSON 片段,很容易突破默认 64 字节限制
- Redis 要求 所有 member 和 所有 score 都 ≤ 该值,只要一个超标,整个 ZSet 就退化
- 用
OBJECT ENCODING key查到skiplist时,大概率是 value 超长,不是元素太多
怎么确认你的真实 value 长度
别猜,实测。对线上热点 ZSet 执行:
ZRANGE your:zset:key 0 4 WITHSCORES
然后人工或用脚本计算每个 member 和 score 的字节数(注意:不是 strlen(),而是 len(bytes);UTF-8 下中文字符占 3 字节,emoji 可能占 4 字节):
- 用 Python 快速验证:
len("user:abc123".encode())→ 12 -
len(str(1672531200).encode())→ 10 - 若 score 是毫秒时间戳,如
1734623640123,长度是 13 字节 - 若 member 是
"order:20261019:uid:987654321",长度已达 31 字节 —— 看似安全,但加上业务扩展字段就危险
调参前必须核对的三个边界条件
盲目设 zset-max-ziplist-value 128 可能适得其反:
- ziplist 是连续内存块,value 增大后插入/删除更易触发整块 realloc,O(n) 开销上升
- Redis 7.0+ 已用
listpack替代 ziplist,但配置名仍沿用旧逻辑;若你用的是 7.2+,实际生效的是zset-max-listpack-value,旧参数被忽略 - 当 value 普遍 > 64 字节时,设成
0反而是最优解:明确禁用 ziplist/listpack,避免运行时反复判断和编码切换开销 - 若 ZSet 读多写少且 value 稳定在 40–55 字节之间,可保守设为
64;若波动大,建议先压测再调
真正省内存的关键,不是把参数拉到最大,而是让数据自然贴合编码边界 —— 比如统一用 8 字节整数 ID 代替字符串 UID,或把 score 改为紧凑序列号而非长精度时间戳。参数只是兜底,设计才是源头。

















