pubsub numsub 返回0是因为它只统计当前活跃连接中的订阅者,不持久化、无心跳;常见原因包括客户端断连、未进入监听态、代理/集群不透传等。

为什么 PUBSUB NUMSUB 返回的数字经常是 0?
直接执行 PUBSUB NUMSUB channel_name 却看到 0,不是因为没人在订阅,而是这个命令只统计「当前连接中」正在监听该 channel 的客户端——一旦客户端断开(比如脚本退出、网络中断、超时关闭),它就立刻从计数中消失。Redis 不持久化订阅关系,也不做心跳维持。
常见误操作包括:
- 在本地终端运行一次
redis-cli,执行SUBSCRIBE mychan后直接关掉窗口:这个订阅从未被计入,因为SUBSCRIBE是阻塞命令,NUMSUB在另一连接里查不到它(除非你另开一个 client 并保持 SUBSCRIBE 连接活跃) - 用 Python 的
redis-py调用pubsub().subscribe()但没调用listen()或没保持循环读取:连接建立后未进入监听态,Redis 不认为它是“活跃订阅者” - 使用了 Redis 代理(如 Twemproxy、Codis)或集群模式:这些中间件通常不透传
PUBSUB命令,NUMSUB可能始终返回空或报错
PUBSUB NUMSUB 的实际可用场景和限制
它只适用于单机 Redis 实例,且要求你能在服务端直连执行命令。生产环境若启用了 ACL,还需确保当前用户有 pubsub 权限(对应 ~* +@pubsub 规则)。
执行方式示例:
PUBSUB NUMSUB news updates alerts
会返回类似:
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
1) "news" 2) (integer) 3 3) "updates" 4) (integer) 1 5) "alerts" 6) (integer) 0
注意:
- 参数可以是多个 channel,Redis 会逐个返回结果;不传 channel 则返回所有已订阅 channel 的列表(不含数量)
- 返回的是「连接数」,不是「独立客户端数」:一个 client 用
PSUBSCRIBE *同时监听多个 channel,会在每个匹配 channel 的计数里 +1 - 没有通配符支持:
PUBSUB NUMSUB "log.*"不生效,必须指定确切 channel 名
想监控长期活跃订阅者?别只靠 NUMSUB
它本质是个瞬时快照,无法告诉你谁订了、何时订的、是否卡住。真要排查问题,得结合其他手段:
- 用
CLIENT LIST筛选cmd=subscribe或cmd=psubscribe的连接:client-addr和age能帮你定位长连接或异常僵死连接 - 在应用层埋点:比如用 Redis 的
SET myapp:sub:<code>client_id1 EX 30 模拟租约,配合定时刷新和过期清理 - 避免依赖订阅数做关键逻辑:比如“等 5 个 subscriber 就发消息”,这在分布式环境下极易因网络抖动失败;改用确认机制(ACK)或消息队列更可靠
Python 中正确获取订阅数的最小可行代码
用 redis-py 执行时,别忘了显式解包响应:
r = redis.Redis()
result = r.pubsub_numsub("user_events", "system_logs")
# result 是 [('user_events', 2), ('system_logs', 0)]
for channel, count in result:
print(f"{channel}: {count}")
注意点:
-
pubsub_numsub()方法在较新版本(>=4.0)中才支持;旧版需用execute_command("PUBSUB", "NUMSUB", ...) - 如果传入空字符串或
None,部分版本会抛ResponseError,建议提前过滤掉无效 channel 名 - 不要在高频循环里反复调用——它本身不耗资源,但频繁网络往返可能压垮 client 连接池
Redis 的订阅者统计从来不是个精确仪表盘,而是一面模糊的镜子。真正容易被忽略的,是把 NUMSUB 当成状态依据去驱动业务逻辑——它反映的只是此刻 TCP 连接表里的一个标记,不是订阅者的意图,也不是消息可达性的保证。










