深入理解mranney/node_redis中的发布订阅(Pub/Sub)机制
2026-02-04 05:24:04作者:韦蓉瑛
什么是Redis的发布订阅模式
Redis的发布订阅(Publish/Subscribe)模式是一种消息通信模式,它允许消息的发送者(发布者)将消息发送到特定的频道,而订阅了该频道的接收者(订阅者)则会接收到这些消息。这种模式实现了消息的广播机制,非常适合构建实时通知系统、聊天应用等场景。
在node_redis中实现Pub/Sub
在mranney/node_redis项目中,发布订阅功能通过RedisClient和RedisCluster类实现。由于Pub/Sub需要独立的客户端连接,我们通常需要创建一个专用的订阅客户端。
创建订阅客户端
// 复制现有客户端创建订阅者
const subscriber = client.duplicate();
subscriber.on('error', err => console.error(err));
await subscriber.connect();
这种方式确保了订阅操作不会阻塞常规的Redis命令执行。
订阅频道的三种方式
node_redis提供了三种订阅模式,满足不同场景需求:
-
普通订阅:精确匹配频道名称
await client.subscribe('news', (message, channel) => { console.log(`收到来自${channel}的消息: ${message}`); }); -
模式订阅:使用通配符匹配多个频道
await client.pSubscribe('news.*', (message, channel) => { console.log(`收到匹配${channel}的消息: ${message}`); }); -
分片订阅:集群环境下的特殊订阅方式
await client.sSubscribe('cluster_news', (message, channel) => { console.log(`收到分片频道${channel}的消息: ${message}`); });
发布消息
发布消息相对简单,但要注意与订阅方式对应:
// 普通发布
await client.publish('news', '最新资讯');
// 分片发布
await client.sPublish('cluster_news', '集群消息');
取消订阅
合理管理订阅关系是良好实践,node_redis提供了灵活的取消订阅方式:
-
取消所有订阅
await client.unsubscribe(); // 普通订阅 await client.pUnsubscribe(); // 模式订阅 await client.sUnsubscribe(); // 分片订阅 -
取消特定频道的订阅
await client.unsubscribe('news'); await client.unsubscribe(['news', 'weather']); -
取消特定监听器
const listener = (msg, ch) => console.log(msg); await client.subscribe('news', listener); // 之后取消 await client.unsubscribe('news', listener);
二进制数据支持
node_redis全面支持Buffer类型的数据传输,这在处理二进制数据时非常有用:
// 订阅二进制频道
await subscriber.subscribe('binary_channel', message => {
console.log(message); // <Buffer ...>
}, true); // 注意第三个参数设为true表示二进制模式
// 发布二进制消息
await subscriber.publish(
Buffer.from('binary_channel'),
Buffer.from('binary message')
);
集群环境下的特殊事件
在Redis集群环境中,当分片频道的槽位(slot)被迁移到其他分片时,会触发sharded-channel-moved事件:
client.on('sharded-channel-moved', (channel, listeners) => {
console.log(`频道 ${channel} 已迁移`);
// listeners包含当前频道的所有监听器
});
最佳实践与注意事项
-
避免重复订阅:多次订阅同一频道会创建多个监听器,每条消息都会触发所有监听器
-
错误处理:务必为订阅客户端添加错误处理逻辑
-
连接管理:订阅客户端需要保持长连接,注意网络稳定性
-
性能考量:大量频道订阅会影响Redis性能,合理设计频道结构
-
集群环境:在集群中使用分片Pub/Sub(sSubscribe/sPublish)以获得最佳性能
通过深入理解这些概念和API,开发者可以充分利用node_redis的Pub/Sub功能构建高效、可靠的实时消息系统。
登录后查看全文
热门项目推荐
相关项目推荐
GLM-5智谱 AI 正式发布 GLM-5,旨在应对复杂系统工程和长时域智能体任务。Jinja00
GLM-5-w4a8GLM-5-w4a8基于混合专家架构,专为复杂系统工程与长周期智能体任务设计。支持单/多节点部署,适配Atlas 800T A3,采用w4a8量化技术,结合vLLM推理优化,高效平衡性能与精度,助力智能应用开发Jinja00
jiuwenclawJiuwenClaw 是一款基于openJiuwen开发的智能AI Agent,它能够将大语言模型的强大能力,通过你日常使用的各类通讯应用,直接延伸至你的指尖。Python0193- QQwen3.5-397B-A17BQwen3.5 实现了重大飞跃,整合了多模态学习、架构效率、强化学习规模以及全球可访问性等方面的突破性进展,旨在为开发者和企业赋予前所未有的能力与效率。Jinja00
AtomGit城市坐标计划AtomGit 城市坐标计划开启!让开源有坐标,让城市有星火。致力于与城市合伙人共同构建并长期运营一个健康、活跃的本地开发者生态。01
awesome-zig一个关于 Zig 优秀库及资源的协作列表。Makefile00
项目优选
收起
deepin linux kernel
C
27
12
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
601
4.04 K
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
69
21
Ascend Extension for PyTorch
Python
441
531
AscendNPU-IR是基于MLIR(Multi-Level Intermediate Representation)构建的,面向昇腾亲和算子编译时使用的中间表示,提供昇腾完备表达能力,通过编译优化提升昇腾AI处理器计算效率,支持通过生态框架使能昇腾AI处理器与深度调优
C++
112
170
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.46 K
823
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
922
770
暂无简介
Dart
846
204
React Native鸿蒙化仓库
JavaScript
321
375
openGauss kernel ~ openGauss is an open source relational database management system
C++
174
249