深入理解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功能构建高效、可靠的实时消息系统。
登录后查看全文
热门项目推荐
相关项目推荐
Kimi-K2.5Kimi K2.5 是一款开源的原生多模态智能体模型,它在 Kimi-K2-Base 的基础上,通过对约 15 万亿混合视觉和文本 tokens 进行持续预训练构建而成。该模型将视觉与语言理解、高级智能体能力、即时模式与思考模式,以及对话式与智能体范式无缝融合。Python00- QQwen3-Coder-Next2026年2月4日,正式发布的Qwen3-Coder-Next,一款专为编码智能体和本地开发场景设计的开源语言模型。Python00
xw-cli实现国产算力大模型零门槛部署,一键跑通 Qwen、GLM-4.7、Minimax-2.1、DeepSeek-OCR 等模型Go06
PaddleOCR-VL-1.5PaddleOCR-VL-1.5 是 PaddleOCR-VL 的新一代进阶模型,在 OmniDocBench v1.5 上实现了 94.5% 的全新 state-of-the-art 准确率。 为了严格评估模型在真实物理畸变下的鲁棒性——包括扫描伪影、倾斜、扭曲、屏幕拍摄和光照变化——我们提出了 Real5-OmniDocBench 基准测试集。实验结果表明,该增强模型在新构建的基准测试集上达到了 SOTA 性能。此外,我们通过整合印章识别和文本检测识别(text spotting)任务扩展了模型的能力,同时保持 0.9B 的超紧凑 VLM 规模,具备高效率特性。Python00
KuiklyUI基于KMP技术的高性能、全平台开发框架,具备统一代码库、极致易用性和动态灵活性。 Provide a high-performance, full-platform development framework with unified codebase, ultimate ease of use, and dynamic flexibility. 注意:本仓库为Github仓库镜像,PR或Issue请移步至Github发起,感谢支持!Kotlin08
VLOOKVLOOK™ 是优雅好用的 Typora/Markdown 主题包和增强插件。 VLOOK™ is an elegant and practical THEME PACKAGE × ENHANCEMENT PLUGIN for Typora/Markdown.Less00
热门内容推荐
最新内容推荐
项目优选
收起
deepin linux kernel
C
27
11
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
532
3.75 K
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
336
178
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
886
596
Ascend Extension for PyTorch
Python
340
405
暂无简介
Dart
772
191
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
12
1
openJiuwen agent-studio提供零码、低码可视化开发和工作流编排,模型、知识库、插件等各资源管理能力
TSX
986
247
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
416
4.21 K
React Native鸿蒙化仓库
JavaScript
303
355