Redis Pub/Sub连接失败主因是容器网络隔离或redis.conf配置错误:需确保容器在同一自定义Docker网络、使用服务名而非localhost、bind 0.0.0.0、protected-mode no,并用conntrack验证ESTABLISHED连接。

连不上不是代码写错了,是容器网络和Redis服务端配置没对齐。Pub/Sub 连接卡住、无响应、超时,90% 以上的问题出在容器网络隔离或 redis.conf 的监听/安全设置上。
容器是否在同一个自定义 Docker 网络里
默认 bridge 网络不支持跨容器服务名解析,localhost 在容器内永远指向自己,不是 Redis 实例。Pub/Sub 依赖双向 TCP 长连接,DNS 解析失败或路由不通会导致 SUBSCRIBE 命令卡住不动。
- 用
docker inspect redis-container | jq '.[0].NetworkSettings.Networks'确认 Redis 容器已加入你期望的网络(如app_net) - 进发布端容器执行
ping redis-service(redis-service是docker-compose.yml里定义的服务名),不通就说明网络没通 - 别用
127.0.0.1或宿主机 IP 写在客户端配置里——Docker 内置 DNS 只认服务名
Redis 是否监听 0.0.0.0 且 protected-mode 关闭
容器内运行的 Redis 默认仍启用 protected-mode yes,且 bind 为 127.0.0.1,这会让所有跨容器请求被直接拒绝,日志里可能只显示静默断连,没有明确错误。
- 挂载自定义
redis.conf,确保包含:bind 0.0.0.0protected-mode norequirepass yourpassword(如果启用了密码) - 不挂配置文件时,可用命令行覆盖:
redis-server --bind 0.0.0.0 --protected-mode no --requirepass yourpassword - 验证是否生效:进容器执行
redis-cli -h redis-service -p 6379 ping,返回PONG才算基础连通
如何确认 Pub/Sub 连接真建立了
ss 和 lsof 在宿主机查不到 Pub/Sub 连接,因为它们属于容器网络命名空间;唯一可靠的方式是查内核 conntrack 表——它能看到经过 NAT 的 ESTABLISHED 连接。
- 先获取 Redis 容器 IP:
docker inspect redis-container | grep IPAddress(如"IPAddress": "172.18.0.3") - 再运行:
sudo conntrack -L --dst 172.18.0.3 --dport 6379 | grep ESTABLISHED - 有输出说明至少一个客户端连上了;为空,说明订阅端根本没发起到 Redis 的 TCP 握手,问题还在网络层或客户端 host 配置
客户端是否用了专用订阅连接而非复用普通连接池
Pub/Sub 是阻塞式长连接,混用普通命令连接池会导致池耗尽、其他请求超时,而订阅本身又不会报错,只是“没反应”。
- Spring Data Redis:
Lettuce的pool配置不作用于 Pub/Sub,必须用StatefulRedisPubSubConnection独立管理 - Redisson:必须显式设
setSubscriptionConnectionPoolSize(20),默认只有 1 个订阅连接 - PHP/Hyperf:需在
redis.php的options中加\Redis::OPT_READ_TIMEOUT => -1,否则 PHP 层会中断阻塞调用
最容易被忽略的是:即使网络通了、配置对了、客户端也发出了 SUBSCRIBE,若没启用 tcp-keepalive 或云厂商 NAT 网关空闲 5 分钟断连,连接会在无声中失效——得靠 conntrack 查,而不是等日志报错。


















