Redis PUBSUB SHARDCHANNELS 怎么核对分片订阅：频道可见性、节点范围与故障排查

Redis Cluster 接入分片 Pub/Sub 后，监控里最容易出现一个误判：在某个节点执行 PUBSUB CHANNELS 没看到频道，就以为订阅已经断了。分片频道应该用 PUBSUB SHARDCHANNELS 观察，而且它返回的是当前节点分片范围内的活跃频道；要确认订阅者数量，还要继续执行 PUBSUB SHARDNUMSUB 并核对节点范围。

先分清普通频道和分片频道

PUBSUB CHANNELS 面向普通 Pub/Sub 频道，PUBSUB SHARDCHANNELS 面向 Redis 7.0 引入的分片频道。两者都只报告当前有一个或多个订阅者的活跃频道，不会告诉你历史上曾经存在过哪些频道，也不会把“发布过消息”当成活跃证据。

这里的“当前节点范围”很关键。官方文档明确说明，分片频道查询返回的是 shard level 信息，而不是 cluster level 总览。单次返回空数组，只能说明这条连接所在范围当前没有匹配频道，不能直接推出全局无人订阅。

生产目标：把频道可见性和订阅数量分开验收

线上告警通常只有一句“频道没人监听”。处理这类告警时，先保存连接节点、频道模式和命令原始输出，再做数量判断。这样能把“频道不存在”“频道在另一节点”“频道存在但订阅数已变为零”分开。

# 连接到待核对的 Redis Cluster 节点
redis-cli -h 10.0.0.21 -p 6379 PUBSUB SHARDCHANNELS

# 只查订单相关的分片频道
redis-cli -h 10.0.0.21 -p 6379 PUBSUB SHARDCHANNELS 'orders:*'

# 对已发现的频道继续查订阅数
redis-cli -h 10.0.0.21 -p 6379 PUBSUB SHARDNUMSUB orders:created orders:paid

在 RESP 返回中，频道清单是字符串数组；SHARDNUMSUB 则按“频道、数量”成对返回。没有匹配频道时，前一条命令返回空数组；没有订阅者的频道不会因为曾经发布过消息而自动出现在清单里。

逐节点核对：不要把一次空结果当成集群故障

分片 Pub/Sub 会按频道名把频道分配到槽位，相关订阅只涉及拥有该槽位的分片。排查时建议为每个节点保留一份结果，至少记录节点地址、执行时间、匹配模式、频道列表和订阅数量。

1. 先从集群节点清单取出每个主节点地址，避免只连接应用配置里的第一个地址。
2. 在每个主节点执行 PUBSUB SHARDCHANNELS 'orders:*'，把返回频道名按字典序保存。
3. 对每个返回频道执行 PUBSUB SHARDNUMSUB，检查数量是否为零或突然低于业务基线。
4. 把空结果与连接节点、频道哈希槽和订阅客户端的连接地址放在一起比较。
5. 确认订阅客户端使用的是 SSUBSCRIBE，不要拿普通 SUBSCRIBE 的监控结果替代分片订阅证据。

权限边界和日志审计怎么做

这组命令属于 Pub/Sub 查询路径，生产巡检账号应只获得必要的命令权限，不要为了排查方便直接绑定全能账号。Redis ACL 配置完成后，用一个无副作用的连接执行命令，记录返回的频道名和数量，不要把消息正文、连接凭据或客户端认证信息写进工单。

如果日志系统会自动采集命令行，建议把主机地址按环境脱敏，把频道名中的用户标识改成固定样例。故障证据需要可复核，但不应该把真实租户名和订阅端标识扩散到普通日志。

常见误区：四个结果不能混为一谈

把 SHARDCHANNELS 当成集群总览

它是节点范围查询。要做全局判断，必须遍历目标分片节点并去重汇总，不能拿单节点空数组做结论。

用 CHANNELS 查询分片频道

普通频道和分片频道是两条不同的订阅路径。监控项应按协议分别命名，否则很容易把“普通频道为空”误报成“分片订阅中断”。

看到频道名就认为消费者健康

频道出现在活跃清单，只能说明至少有订阅者。还要用 SHARDNUMSUB 取数量，并结合客户端连接状态和业务心跳判断消费者是否真的工作。

用高频全量扫描替代事件监控

SHARDCHANNELS 的复杂度与活跃分片频道数有关，频道很多时不要把它当作每秒执行的全量探针。生产环境可降低巡检频率，并在告警时收集一次详细证据。

发布前的最小检查清单

• 命令名称是 PUBSUB SHARDCHANNELS，没有误写成普通频道查询。
• 采样结果带有节点地址和模式参数，能回到原始命令重放。
• 每个活跃频道都能用 SHARDNUMSUB 得到数量，空频道和零订阅被区别记录。
• 跨节点结果完成去重，不把单节点结果包装成集群总览。
• 日志中没有凭据、消息正文和不必要的真实租户标识。

相关问题

PUBSUB SHARDCHANNELS 从哪个节点执行？

应在需要核对的 Redis Cluster 分片节点上执行。单个节点的结果只覆盖它自己的分片范围；做集群判断时要逐节点查询。

为什么刚发布过消息却查不到频道？

活跃频道的定义取决于是否存在订阅者，不是是否发布过消息。没有订阅者时，频道不会因为历史消息自动保留在清单中。

SHARDCHANNELS 能直接返回订阅数量吗？

不能。它只返回频道名；需要把频道名传给 PUBSUB SHARDNUMSUB 再核对订阅数量。

Redis 旧版本能使用这条命令吗？

Redis 官方文档标注分片 Pub/Sub 查询从 Redis Open Source 7.0.0 起提供。连接到更早版本前，先做命令能力探测并准备普通 Pub/Sub 的兼容路径。

把空结果变成可验证的判断

一次命令输出只是一份局部证据：频道清单回答“这里当前看到了什么”，订阅数量回答“这些频道有多少监听者”，逐节点采样才回答“集群范围是否一致”。把三层证据按同一时间窗口保存，排查 Redis 分片订阅时才不会被一个空数组带偏。