redis pub/sub客户端断连主因是client-output-buffer-limit pubsub未配或配置不当；其缓冲区易爆因pub/sub单向广播导致多副本堆积，且消费延迟会快速推高omem值，需结合心跳、消息体积与并发数合理设置hard/soft限制并验证生效。
Redis Pub/Sub 客户端断连，八成是 client-output-buffer-limit pubsub 没配或配错了——它不设限就等于没保护，缓冲区会一路涨到 OOM 或被强制踢出。
为什么 pubsub 缓冲区比 normal 客户端更容易爆掉
PUB/SUB 是单向广播，发布者完全不感知订阅者状态。一条 PUBLISH 到 10 个慢订阅者，Redis 就要往每个客户端的输出缓冲区各塞一份副本。而 normal 客户端（比如执行 GET 或 LRANGE）通常是“发一个、等一个”，缓冲区峰值可控；pubsub 却可能在几秒内堆积上百 MB，尤其当消费逻辑含 I/O、数据库查询或网络调用时。
- 典型场景：YOLO 视频分析服务订阅
video:stream，但帧处理耗时波动大，偶尔卡住 2–3 秒，缓冲区瞬间突破 20MB - 默认配置
client-output-buffer-limit pubsub 32mb 8mb 60看似宽松，但 soft-limit（8MB）触发后若 60 秒内没回落，连接直接断——这不是警告，是熔断 - 注意：hard-limit 达到即暂停写入，但已积压的数据仍占内存；soft-limit + soft-seconds 才是防误杀的关键组合
如何设置合理的 pubsub hard/soft 限制值
不能拍脑袋设 32MB，得结合业务吞吐与心跳节奏来算。例如你用 Python 的 redis-py 订阅，每 30 秒发一次 PING 心跳，那 soft-seconds 至少设为 45，留出网络抖动余量。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
hard-limit：建议明确设非零值（如16mb），禁用（0）等于放弃兜底 -
soft-limit：应略大于单次最大消息体积 × 并发订阅数 × 预估最大积压秒数。例如单条消息平均 100KB，最多 5 个订阅者，容忍积压 10 秒 → 100KB × 5 × 10 ≈ 5MB，soft-limit 可设6mb -
soft-seconds：必须 > 客户端心跳间隔，且建议 ≤ 90 秒；设太短（如 10 秒）会导致频繁断连重连 - 生效方式：改
redis.conf后需redis-cli CONFIG REWRITE或重启，CONFIG SET不支持动态修改该参数
上线前必须检查的三件事
光配对参数不够，得验证真实运行时行为。别等线上报警才看缓冲区大小。
- 用
redis-cli --csv CLIENT LIST | grep pubsub查活跃订阅者，关注omem字段（单位字节），确认是否稳定在 soft-limit 以下 - 模拟慢消费：在订阅端加
time.sleep(2)，观察 60 秒内是否被踢；再调高soft-seconds复测 - 监控项必须加：采集每个 client 的
omem和cmd（应为subscribe或psubscribe），告警阈值设为 hard-limit 的 70% - 注意：
CLIENT LIST输出中flags含P表示 pubsub 客户端，不含则可能是普通连接误用了 subscribe
为什么改了配置还是断连？排查软限制未生效的常见原因
很多团队改完 client-output-buffer-limit pubsub 发现照样断，往往卡在几个隐性环节。
- 配置写在错误位置：必须放在
redis.conf全局段，不能包在include文件里且被覆盖；用redis-cli CONFIG GET client-output-buffer-limit确认返回值含pubsub项 - 客户端没重连：旧连接不会自动应用新配置，必须 kill 掉所有活跃 pubsub 连接，让客户端重建
- 使用了连接池但没清理：比如 Python 的
ConnectionPool默认复用连接，需设max_connections=1或显式调disconnect()强制刷新 - 混淆了 client 类型：有些 SDK（如早期版本 ioredis）默认把 pubsub 连接归类为
normal，导致实际受normal限制而非pubsub限制
真正难的不是设数字，而是把缓冲区增长和业务处理延迟对齐——你得知道消息进来多快、出去多慢、中间卡在哪，否则 hard-limit 再大也只是拖延爆炸时间。
