Redis PUBSUB SHARDCHANNELS 为什么只返回当前节点活跃频道

在 Redis Cluster 里执行 PUBSUB SHARDCHANNELS，只看到当前连接节点的几个频道，并不代表其他订阅已经丢失。这个命令查询的是“当前节点上仍有一个或多个订阅者的 shard channel”，返回范围是节点级，不是整个集群的频道总表。

Redis 7.0 引入 Sharded Pub/Sub 后，shard channel 会按和 key 相同的算法映射到槽位；消息只在所属分片内传播。排查时要把“频道属于哪个分片”和“命令发给哪个节点”分开看。

官方文档：https://redis.io/docs/latest/commands/pubsub-shardchannels/

为什么返回结果看起来少了一半

PUBSUB SHARDCHANNELS 的语义是列出当前节点的活跃 shard channel，可选参数是 glob 风格的匹配模式。它没有承诺扫描所有 master、replica 或整个 cluster bus。因此，客户端连到节点 A 时，看到的是 A 本地的活跃频道；节点 B 上的订阅不会自动拼进同一个返回数组。

这里的“活跃”也很具体：频道必须至少有一个订阅者。只有发布过消息、但当前没有订阅者的名字，不会因为曾经出现过就留在结果里。

先确认你查的是哪一种 Pub/Sub

普通频道和 shard channel 不是同一套统计对象。SSUBSCRIBE、SUNSUBSCRIBE、SPUBLISH 属于 Sharded Pub/Sub；普通的 SUBSCRIBE 和 PUBLISH 则走全局 Pub/Sub 语义。把两套命令混用，会得到看似矛盾的结果。

# 用模式缩小当前节点的查询范围；结果仍然只是本节点数据
redis-cli -h redis-node-a PUBSUB SHARDCHANNELS 'tenant:*'

# 检查客户端是否使用了分片订阅，而不是普通频道订阅
redis-cli -h redis-node-a SSUBSCRIBE tenant:orders

# 分片消息要由拥有该频道槽位的节点接收；不要把任意节点的结果当成集群总览
redis-cli -h redis-node-a SPUBLISH tenant:orders 'event-1'

用分片归属解释“当前节点”

Sharded Pub/Sub 会把频道映射到槽位。发布 shard message 时，命令应送到拥有该槽位的节点；集群再把消息转发给同一分片中的相关节点。订阅端可以连接负责该槽位的主节点，也可以连接它的副本，但查询命令本身依旧只反映被查询节点的本地活跃状态。

因此，发现某频道“不在返回值里”时，优先判断三件事：连接是否落在正确的分片、订阅是否使用了 SSUBSCRIBE、查询模式是否把频道过滤掉。不要先把它当成 Redis 丢数据。

把局部结果变成可用的集群视图

如果监控需要看到全体 shard channel，应用层应维护节点清单，分别向每个相关节点发起 PUBSUB SHARDCHANNELS，再在采集端按“节点、频道、采集时间”合并。这个合并视图是监控系统构造的，不是 Redis 单条命令直接提供的集群级快照。

# 依次查询纳入监控的节点；中文注释说明合并维度，不表示命令输出已在本机执行
for node in redis-node-a redis-node-b redis-node-c; do
  # 记录节点来源，避免同名频道合并后无法定位分片
  redis-cli -h "$node" PUBSUB SHARDCHANNELS '*'
done

# 对每个频道再按业务需要计算槽位或关联节点；不要把结果写成永久事实
# 因为订阅建立或取消后，活跃频道集合会发生变化

采集器还要接受短暂不一致：某个客户端刚建立订阅时，节点查询可能早于订阅状态可见；节点切换、重连和取消订阅也会改变结果。监控上应保留节点维度，并把“没有返回”解释为当前观察点，而不是历史订阅证明。

什么时候不该继续用 Pub/Sub

Redis Pub/Sub 的投递语义是 at-most-once：消息发出后，如果订阅者断线或处理失败，Redis 不会替它补发。SHARDCHANNELS 适合回答“现在这个节点有哪些活跃分片频道”，不适合承担可靠消息积压、重放或消费确认。

如果需求已经变成断线续读、失败重试、消费组或审计留痕，应评估 Redis Streams。把实时频道发现和可靠消息存储拆开，排查结果也会更容易解释。

常见问题

为什么连接副本也可能看到频道？

Sharded Pub/Sub 允许客户端连接负责槽位的主节点或其副本；但命令返回仍是被查询节点自己的活跃频道范围。

给 SHARDCHANNELS 加模式会扫描整个集群吗？

不会。模式只过滤当前节点可见的活跃 shard channel，不会把查询扩展成集群广播。

频道刚发布过，为什么查询不到？

因为命令关心的是当前是否存在订阅者，而不是频道是否曾经被发布过。没有订阅者的频道不属于 active shard channels。

总结

《Redis PUBSUB SHARDCHANNELS 为什么只返回当前节点活跃频道》的关键答案是：这是节点级活跃状态查询。先区分普通 Pub/Sub 与 Sharded Pub/Sub，再确认频道槽位和连接节点；需要集群总览时由采集端逐节点汇总，涉及可靠投递时另看 Redis Streams。