Redis SUNIONCARD 怎样在达到阈值后停止并集计数

线上做“一个用户至少命中若干标签吗？”这类判断时，直接把多个 Set 做完整并集再取长度，常常把不需要的成员结果搬到应用侧。Redis 的 SUNIONCARD 只返回并集基数；再配合 LIMIT，当计数达到阈值就可以停止。要注意：提前停止时返回的是阈值上限，不是完整并集的精确总数。

官方地址：https://redis.io/docs/latest/commands/sunioncard/

只关心“是否达到 N 个”时使用 LIMIT N；需要精确总数时省略 LIMIT 或使用 LIMIT 0。

先把 SUNIONCARD 看成数量查询

SUNION 返回成员集合，SUNIONCARD 则只返回这个并集的数量。命令格式是 SUNIONCARD numkeys key [key ...] [LIMIT limit]，其中 numkeys 必须与后面的集合键数量对应。

# 只读取并集数量，不把成员列表返回给客户端
SADD team:backend go redis mysql
SADD team:data redis mysql kafka
SUNIONCARD 2 team:backend team:data
# 返回整数 5，表示去重后的并集基数

它适合把“集合有多大”作为判断条件，而不是把所有成员传回业务代码。Redis 官方文档将该命令标记为 Redis 7.0.0 起可用，最坏复杂度与最小集合基数和集合数量有关。

用 LIMIT 表达“达到阈值即可”

例如只需要判断并集是否至少有 3 个成员，可以写成：

# LIMIT 3 表示达到 3 个后即可结束计数
SUNIONCARD 2 team:backend team:data LIMIT 3
# 返回 3 时，只能确认并集数量至少达到 3

LIMIT 0 是默认值，表示不设置上限。正数 LIMIT 则是业务阈值，不是分页大小，也不会把并集结果截成某个成员列表。这个区别能避免把“达标”误写成“精确计数”。

LIMIT 返回值为什么可能只是上限

当真实并集基数小于 LIMIT 时，命令会返回真实数量；当真实基数达到 LIMIT，计数可以提前结束并返回 LIMIT。因此下面两种返回都可能是 3：

• 真实并集刚好有 3 个成员，返回 3；
• 真实并集有 30 个成员，达到 3 后提前返回 3。

所以，返回值与 LIMIT 比较时适合写成“是否达到阈值”，不要记录成精确总数。需要报表、配额或审计数字时，应去掉 LIMIT 重新获取完整基数，并为大集合查询单独评估耗时。

空键、复杂度与多键部署边界

不存在的键按空集合处理；只要其中一个参与并集的键不存在，结果仍由其它键决定。所有键都不存在时返回 0。SUNIONCARD 是只读命令，但多个键的访问仍要考虑部署拓扑；Redis 官方文档提示，多键操作在集群环境中的行为需要结合集群多键规则判断。

故障复盘时可以按三件事定位：第一，确认 numkeys 没有把业务参数误当成键；第二，确认调用方是否把返回 LIMIT 当成精确总数；第三，确认多键是否满足当前 Redis 部署的同槽或路由要求。只有这三点都清楚，LIMIT 带来的提前停止才不会转化为数据解释错误。

常见问题

SUNIONCARD LIMIT 能返回被截断的成员吗？不能，它始终返回整数，不返回并集成员。

LIMIT 写成 0 会不会返回 0？不会。0 表示不限制，命令会计算完整并集基数。

什么时候不该使用 LIMIT？需要精确统计、排序或审计留痕时，不要把阈值返回当作总数。