深入理解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功能构建高效、可靠的实时消息系统。
登录后查看全文
热门项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0101- DDeepSeek-V4-ProDeepSeek-V4-Pro(总参数 1.6 万亿,激活 49B)面向复杂推理和高级编程任务,在代码竞赛、数学推理、Agent 工作流等场景表现优异,性能接近国际前沿闭源模型。Python00
MiMo-V2.5-ProMiMo-V2.5-Pro作为旗舰模型,擅⻓处理复杂Agent任务,单次任务可完成近千次⼯具调⽤与⼗余轮上 下⽂压缩。Python00
GLM-5.1GLM-5.1是智谱迄今最智能的旗舰模型,也是目前全球最强的开源模型。GLM-5.1大大提高了代码能力,在完成长程任务方面提升尤为显著。和此前分钟级交互的模型不同,它能够在一次任务中独立、持续工作超过8小时,期间自主规划、执行、自我进化,最终交付完整的工程级成果。Jinja00
Kimi-K2.6Kimi K2.6 是一款开源的原生多模态智能体模型,在长程编码、编码驱动设计、主动自主执行以及群体任务编排等实用能力方面实现了显著提升。Python00
MiniMax-M2.7MiniMax-M2.7 是我们首个深度参与自身进化过程的模型。M2.7 具备构建复杂智能体应用框架的能力,能够借助智能体团队、复杂技能以及动态工具搜索,完成高度精细的生产力任务。Python00
最新内容推荐
阅读APP书源高效配置技巧:二维码导入方案全解析7个维度解析log-lottery:企业级3D抽奖系统的技术架构与实践指南4个步骤实现文档数字化转型:构建企业级智能文档管理系统如何用300元打造会思考的无人机?开源方案全解析突破系统壁垒:用OneClick-macOS-Simple-KVM实现跨平台虚拟机部署与优化3分钟上手!手柄宏录制让你告别90%重复操作Windows系统级安卓设备连接与驱动配置解决方案7个技巧教你用Rufus制作启动盘:从入门到精通的系统安装解决方案5分钟掌握foobox-cn兼容性指南:从安装到功能适配全解析突破边界:TrackWeight如何让MacBook触控板变身精度电子秤的隐藏潜能
项目优选
收起
暂无描述
Dockerfile
710
4.51 K
Claude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed.
Get Started
Rust
596
101
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.61 K
944
deepin linux kernel
C
28
16
Ascend Extension for PyTorch
Python
573
694
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
416
341
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
958
955
昇腾LLM分布式训练框架
Python
150
177
基于服务器管理南向接口技术要求实现的部件驱动库。Hardware component drivers framework with unified management interface
C++
15
77
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
1.43 K
116