actioncable在多进程/多服务器部署时必须配置redis广播适配器,否则跨进程广播失效;需正确设置cable.yml中的adapter、url、channel_prefix,并避免redis db冲突。

ActionCable 本身不依赖 Redis 发布订阅来工作,它用的是自己的 WebSocket 连接管理和广播机制。但如果你在高并发部署(多进程/多服务器)下使用 ActionCable,必须配置 Redis 作为广播适配器,否则客户端收不到跨进程的广播消息——这是最常被忽略的前提。
ActionCable 的广播机制默认不跨进程
- 开发环境(单进程)下,
ActionCable默认用inline广播适配器,消息只在当前进程内传递; - 生产环境多 Puma worker 或多台服务器时,
inline完全失效:A 进程里的stream_from订阅者收不到 B 进程调用的broadcast; - 此时必须切换为
redis广播适配器,它底层正是靠 Redis 的PUBLISH/SUBSCRIBE实现跨进程消息中继。
你需要做的是:
- 确保
config/cable.yml中 production 环境指定了 Redis URL - 不要手动用
Redis.current.publish绕过ActionCable自己的广播流程 - 所有广播必须走
Channel#broadcast或ActionCable.server.broadcast
# config/cable.yml production: adapter: redis url: channel_prefix: myapp_production
redis-cli 能看到 ActionCable 的频道,但别直接操作
ActionCable 使用 Redis 的 Pub/Sub 模式,频道名格式是:action_cable<em>broadcast</em><channel_name></channel_name>(加上 channel_prefix 后缀)。你可以用 redis-cli 监听验证:
redis-cli > SUBSCRIBE action_cable_broadcast_notifications
但注意:
- 手动
PUBLISH到这个频道不会触发Channel#received,因为缺少ActionCable协议封装(如message字段结构、identifier标识等); - 直接
SUBSCRIBE也收不到完整消息体,ActionCable的 Redis 适配器实际用的是PSUBSCRIBE+ 模式匹配(如action_cable<em>broadcast</em>*),并做了序列化包装; - 若你在 Ruby 中另起一个
Redis.current.subscribe长连接监听同名频道,会和ActionCable的 Redis 连接冲突(共享连接池时可能断连或丢消息)。
多服务器部署时,Redis 配置漏掉 channel_prefix 会导致消息混串
- 如果两个 Rails 应用(比如 staging 和 production)共用同一个 Redis DB 且没设
channel_prefix,它们的notifications频道会互相干扰; -
channel_prefix不是可选项,是隔离必需项; - 同时检查
redis://URL 的 DB 编号(如/1)是否与其他服务(如 Sidekiq、缓存)冲突——建议给ActionCable单独分配一个 DB。
你得确认:
-
REDIS_URL环境变量里包含明确 DB 号,例如redis://localhost:6379/2 -
channel_prefix在cable.yml中与环境名一致(如myapp_production) - 所有服务器节点读取的是同一份
cable.yml配置,且没有被ENV覆盖错
ActionCable 借 Redis 实现广播,不是让你去“用 Redis 写个订阅逻辑替代它”,而是让它在分布式场景下能继续可靠工作——真正容易出问题的,从来不是代码怎么写,而是那几行 YAML 里少了个下划线、URL 少了个数字、或者 prefix 没区分环境。











