Valkey 9.2.0 升级笔记:三处会改掉现有行为的变更,以及 forkless 快照的每键 4 字节
发布说明:valkey-io/valkey 9.2.0|下载:valkey.io/download/9.2
9.2.0 是 9.2 分支的首个稳定版,升级紧迫度标为 LOW。不过下面几条会改掉现有实例的行为,滚动升级前先逐条对照核查。
升级前先确认三件事
1. 空的 score bound 现在会报错。 ZRANGEBYSCORE、ZREVRANGEBYSCORE、ZCOUNT、ZRANGESTORE 收到裸 ( 或空字符串时,不再默默当成 0,而是直接报错(#4054)。客户端拼接参数时漏掉取值的地方,升级后才会暴露。建议先在业务代码和代理层搜一遍这几个命令的参数拼接逻辑。
2. OBJECT ENCODING 从 skiplist 变成 btree。 大 sorted set 改用 B+ 树实现(#4359),OBJECT ENCODING 返回 btree;巡检脚本、监控断言里写死 skiplist 的地方会全部误报。先修改这些断言,再升级。
3. forkless 开启后每个键多 4 字节,且 forkless-infrastructure-enabled 只能在启动时设置。 运行期修改不会生效,必须改配置文件重启。容量评估按 键数量 × 4 字节 预留;实际内存增量与延迟影响需自行验证。
另外两条行为变更
- Path Hash 的删除命令在删掉最后一个 path 时会移除整个 key,符合 Hash 的 key 生命周期,并发出通用的 del 事件(#5068)。依赖“path 删空但 key 仍在”的下游逻辑要跟着改。
- key 和 hash field 的主动过期现在会递增 dirty 计数器,因此 save point(进而 BGSAVE)可能触发得更频繁(#3118)。已有持久化频率监控的实例留意一下。
forkless 快照:怎么开、怎么验证
配置侧涉及 forkless-infrastructure-enabled、bgsave-default-method 和 forkless-policy:
forkless-infrastructure-enabled yes
forkless-policy prefer-forkless
prefer-forkless 表示优先用后台线程做快照,失败再回退到 fork。forkless 全量同步同样支持磁盘和 diskless 两种方式,由后台线程快照提供服务,全程不 fork(#4797)。
验证不能只看配置是否被接受,要在 BGSAVE 之后查 INFO:
redis-cli BGSAVE
redis-cli INFO persistence | grep rdb_last_bgsave_type
rdb_last_bgsave_type 显示 forkless 才算真正生效。INFO persistence 里还有新增字段报告保存方法与进度。
repl-compression:按副本协商的 LZ4
repl-compression 为稳态复制加可选 LZ4 流式压缩,协商是逐副本进行的:旧版本副本或主动关闭该选项的副本继续收明文,因此可以按副本灰度,不会因个别副本不支持而断链。官方给出的场景是 300 万 key、每 key 约 315 字节,复制带宽下降 52%,吞吐下降不到 1%;自己拓扑下的收益需自行验证。
rdbcompression 新增 lz4 / zstd
rdbcompression lz4:对 RDB 文件整体做 LZ4 压缩(#3531),默认的 per-string LZF 行为不变。- Zstd 作为 RDB 持久化和复制的流式压缩 codec,压缩率高于 LZ4(#3798),但编译时必须带
BUILD_ZSTD=yes,否则用不了。配置里对应的具体取值需自行验证。 - AOF base 现在支持流式压缩的 RDB preamble,压缩过的全量同步 RDB 文件可以直接复用为 AOF base(#4754)。
rdbcompression lz4
官方数字:RDB 用 LZ4 后备份文件最多小 80%;新副本全量同步快约 35%,持续复制流量下降 50%–65%,代价是每个副本消耗 2%–4% 的单核 CPU。
回退:先切回旧压缩模式,再 BGREWRITEAOF
如果已经用 lz4 或 zstd 写出过 AOF base,直接回退旧版本会读不了这份 base。顺序必须是:
# 先把 rdbcompression 改回旧版本支持的模式
rdbcompression yes
redis-cli BGREWRITEAOF
等重写完成后再回退。流式压缩的 RDB 快照同理,旧版本必须支持对应压缩格式才能加载。
官方公布的数字
以下均为官方公布数据,非本机实测:
- ZADD 压 300 万成员:吞吐 +105%
- 500 万个 20 字节成员:每成员额外开销从 50.3 字节降到 28.5–32.0 字节(-36% ~ -43%,不含成员数据本身)
- LZ4 复制压缩:复制带宽 -52%,吞吐下降 <1%
- RDB LZ4:备份文件最多小 80%
- 新副本全量同步快约 35%,持续复制流量 -50% ~ -65%,每副本 CPU 代价 2%–4% 单核
- 3 字段小 hash:9.1.4 默认 240 字节 → 9.2 的 80 字节
其余变更速览
命令侧:DELEX(值相等/不等才删,IFEQ/IFNE)、INCREX(自增并同时设过期,支持 NX/XX)、XACKDEL/XDELEX(KEEPREF/DELREF/ACKED)、ACL DIGEST 与 ACL roles(SETROLE/DELROLE/GETROLE/ROLES)、HOTKEYS GET/RESET(需设 hotkeys-top-k)、Path Hash 的 PH* 系列(基数树,二进制安全路径,支持精确查找、最长前缀匹配、前缀遍历)。
配置侧:maxmemory-scripts 限制缓存 EVAL 脚本内存,SCRIPT LOAD 标记为 DENYOOM;repl-throttling-enabled 在副本落后时限速客户端写入,避免断连和全量同步;priority-subnets + maxclients-reserved 为管理连接预留槽位,INFO clients 多出 connected_priority_clients;tls-alt-cert-file 等支持第二张证书(例如后量子证书与 RSA 并存);priority-preemptive-poll-interval-us 调整系统关键事件(心跳、复制、槽迁移)的抢占优先级。
性能修复:小 key 上 hashtable 收缩期间 SRANDMEMBER / ZRANDMEMBER / HRANDFIELD / SPOP 的长停顿(#5170);XTRIM MAXLEN = 0 约快 2.5 倍;删除时压缩稀疏 B+ 树叶子以回收内存;带字段过期的小 hash 改用 listpack 而不是直接转 hashtable。