Redis ZUNIONSTORE 如何合并排行榜：权重计算、聚合规则与结果键核对

线上做综合排行榜时，最容易出错的不是“能不能合并”，而是合并后的分值到底代表什么。Redis 的 ZUNIONSTORE 会把多个 Sorted Set 的成员并到一个目标键；同名成员默认按分值求和，只有明确写出 WEIGHTS 和 AGGREGATE，结果才符合业务权重。下面用周榜和月榜演示一遍完整核对过程。

先记住一个判断：ZUNIONSTORE destination numkeys key... 先决定“哪些键参与合并”，WEIGHTS 再改各键分值，AGGREGATE 最后决定同一成员如何聚合；返回值是写入结果键的成员数量。

先准备两份 Sorted Set，确认成员和分值

把周榜和月榜拆成两个键，故意让 alice 同时出现在两边，让 bob 只出现在周榜，让 carol 只出现在月榜。这样既能观察重叠成员，也能检查并集成员数量。

ZADD rank:weekly 10 alice 8 bob
ZADD rank:monthly 30 alice 12 carol
ZRANGE rank:weekly 0 -1 WITHSCORES
ZRANGE rank:monthly 0 -1 WITHSCORES

这里先别急着看最终名次。先确认两个键的类型都是 Sorted Set，并确认测试环境里没有残留的 rank:all；否则旧结果键会让排查变得很混乱。

ZUNIONSTORE 如何把输入成员写入 rank:all

最小写法如下。第二个参数 2 表示后面紧跟两个输入键，Redis 会将并集保存到 rank:all。

DEL rank:all
ZUNIONSTORE rank:all 2 rank:weekly rank:monthly
ZRANGE rank:all 0 -1 WITHSCORES

返回值应为 3，因为并集成员是 alice、bob、carol。其中 alice 的默认分值是 10 + 30 = 40，另外两个成员分别保留各自分值。

numkeys 写错时，先看命令边界

numkeys 不是结果数量，而是输入键数量。把命令写成 ZUNIONSTORE rank:all 3 rank:weekly rank:monthly，Redis 会继续等待第三个输入键；把它写成 1，则只会把 rank:weekly 当成输入，后续参数也会被重新解释。这个错误应在命令拼装层修，不要靠删除结果键掩盖。

WEIGHTS 和 AGGREGATE 的计算顺序

如果周榜只占综合分的 40%，月榜占 60%，可以显式指定两个权重，并把同一成员的加权分值用 SUM 合并：

DEL rank:all
ZUNIONSTORE rank:all 2 rank:weekly rank:monthly WEIGHTS 0.4 0.6 AGGREGATE SUM
ZRANGE rank:all 0 -1 WITHSCORES

对 alice 的核算是 10 × 0.4 + 30 × 0.6 = 22；bob 只有周榜分值，结果为 8 × 0.4 = 3.2；carol 只有月榜分值，结果为 12 × 0.6 = 7.2。先乘权重，再按聚合规则合并，这个顺序不能反过来。

SUM、MIN、MAX、COUNT 该怎么选

SUM 适合把多来源贡献累加；MIN 和 MAX 适合保守或取最高分的规则；COUNT 表示成员出现在多少个输入集合中。选择聚合方式前，要先写清“分值是金额、质量分，还是出现次数”，否则命令虽然成功，业务含义却可能错。

结果键的三项验收和生产注意点

命令返回 3 只能证明写入了三个成员，不能证明分值正确。建议按下面顺序验收：

1. 用 TYPE rank:all 确认结果键仍是 zset。
2. 用 ZCARD rank:all 对照命令返回值，确认成员数量一致。
3. 用 ZRANGE rank:all 0 -1 WITHSCORES 核对重叠成员的加权值和单边成员的缩放值。

ZUNIONSTORE 会覆盖同名的目标键，因此目标键最好使用明确的版本或批次后缀，例如 rank:all:2026w35，验收完成后再切换业务读取指针。多键操作在 Redis Cluster 中还要检查键的路由约束，不能只在单机测试通过就直接上线。

相关问题

不同输入键里的成员只出现一次，会怎样计算？

它仍会进入结果键；没有参与该成员的输入集合不会贡献分值，其他集合的 WEIGHTS 仍然会作用于它实际拥有的分值。

为什么结果数量对了，排行榜顺序却不对？

通常是权重或 AGGREGATE 规则与业务定义不一致。先单独算重叠成员，再用 ZRANGE ... WITHSCORES 核对分值，不要只看成员数量。

能不能用 ZUNIONSTORE 直接得到结果而不写目标键？

不能。ZUNIONSTORE 的职责是把并集保存到目标键；只想读取结果时，应评估 Redis 的 ZUNION。

小结

Redis ZUNIONSTORE 的排查重点只有三层：先核对 numkeys 和输入键，再核对 WEIGHTS 的位置与数值，最后核对 AGGREGATE 和结果键分值。把“成员数量验收”和“分值验收”分开，排行榜合并问题就不容易被一个看似正常的返回值带偏。