不能直接用 Redis Pub/Sub 做可靠配置刷新,必须搭配 GET+EXPIRE + 本地缓存兜底;SUBSCRIBE 后收不到更新主因是连接进入只读订阅态,后续命令报错,须单独开长连接,且重连后需手动 subscribe,HTTP 临时订阅无效,单 key 存储更安全,需通配监听 + 兜底轮询防丢。

不能直接用 Redis Pub/Sub 做可靠配置刷新,必须搭配 GET+EXPIRE + 本地缓存兜底,否则重启就丢配置、断连就收不到更新。
为什么 SUBSCRIBE 后收不到配置更新?
根本不是命令写错了,而是连接卡在“订阅模式”里出不来。Redis 的 SUBSCRIBE 会让连接进入只允许执行 SUBSCRIBE/UNSUBSCRIBE/PSUBSCRIBE/PUNSUBSCRIBE 的状态,后续任何 GET、SET 都会报错 ERR only (P)SUBSCRIBE / (P)UNSUBSCRIBE / QUIT allowed in this context。
- 必须为订阅单独开一个长连接(比如用
redis-py的PubSub实例),绝不能和读写配置的Redisclient 共用 - 客户端断连后,Redis 不保存订阅关系,重连后得手动
subscribe()—— 用redis-py要在on_connect回调里补订 - Web 请求中临时
SUBSCRIBE是无效的:HTTP 连接一结束,订阅自动退订,根本等不到消息
配置项该存成 Hash 还是单 key?
存成单 key 更安全,比如 config:app:timeout、config:app:retry,而不是全塞进 config:app 这个 Hash 里。
-
HSET不触发任何通知,改了 Hash 字段不会广播,必须额外PUBLISH才行,频道名极易拼错 - 单 key 可独立设
EXPIRE,过期后能配合键空间通知__keyevent@0__:expired自动触发重拉,默认值逻辑也更清晰 - 读取时建议加一层本地缓存(如
AtomicReference或 Guava Cache),但失效时间必须严格对齐 Redis 的EXPIRE,否则出现脏读 -
GET返回null时,要区分是 key 不存在,还是值就是空字符串——推荐约定空值也写入"null"字符串
怎么让配置变更真正“实时推到各节点”?
靠 PUBLISH/SUBSCRIBE 推送变更事件,但必须接受它“丢了就没了”的现实,不能指望它扛住所有异常场景。
- 发布端执行:
SET config:app:timeout "5000" && EXPIRE config:app:timeout 86400 && PUBLISH config:update:timeout "5000" - 订阅端监听
config:update:*这类通配频道,收到后立刻GET对应 key,避免依赖消息体内容(防篡改、防解析失败) - 必须有兜底机制:启动时全量
SCAN+GET加载,运行中每 30 秒轮询一次关键配置 key,防止因网络抖动或订阅丢失导致配置长期不更新 - 别信“自动重连客户端”能解决一切——
redis-py的PubSub重连后不会自动重订频道,漏掉这步等于没订阅
最常被忽略的是:没有兜底轮询,也没有本地缓存版本号比对,一旦订阅连接静默断开,服务就会一直用旧配置跑下去,连日志都未必报错。


















