差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
| rocketmq [2026/10/16 12:57] – 补充 RocketMQ 新旧版本使用与接入正文教程 张叶安 | rocketmq [2026/10/16 14:11] (当前版本) – 参考小节补充 proto 与 nodejs 客户端链接 张叶安 | ||
|---|---|---|---|
| 行 24: | 行 24: | ||
| ### Java 5.x gRPC | ### Java 5.x gRPC | ||
| ### Spring Boot(rocketmq-spring-boot-starter) | ### Spring Boot(rocketmq-spring-boot-starter) | ||
| - | ### Go / Python / C++ 客户端 | + | ### Go / Python / C++ / Node.js |
| ## 消息类型 | ## 消息类型 | ||
| - 普通消息 | - 普通消息 | ||
| 行 457: | 行 457: | ||
| </ | </ | ||
| - | ===== 七、接入方式四:Go / Python / C++ ===== | + | ===== 七、接入方式四:Go / Python / C++ / Node.js |
| ^ 语言 ^ 4.x(remoting) ^ 5.x(gRPC) ^ | ^ 语言 ^ 4.x(remoting) ^ 5.x(gRPC) ^ | ||
| 行 463: | 行 463: | ||
| | Python | '' | | Python | '' | ||
| | C++ | '' | | C++ | '' | ||
| - | | Rust / Node | 社区客户端居多 | + | | Rust | '' |
| + | | Node.js | '' | ||
| Go(4.x 风格): | Go(4.x 风格): | ||
| 行 520: | 行 521: | ||
| </ | </ | ||
| - | 选型建议:多语言团队优先用 5.x 的 gRPC 客户端,接口在各语言间基本一致;4.x 时代的 Python/Node 客户端维护活跃度较低,新项目不建议依赖。 | + | == Node.js 接 5.x gRPC:官方没客户端,两条路 == |
| + | |||
| + | 先把现状说清楚:官方 '' | ||
| + | |||
| + | === 路径 A:用 @grpc/ | ||
| + | |||
| + | 原理:Proxy 对外暴露的就是标准 gRPC 服务 '' | ||
| + | |||
| + | <code bash> | ||
| + | npm i @grpc/ | ||
| + | |||
| + | # 从 apache/ | ||
| + | # | ||
| + | # | ||
| + | </ | ||
| + | |||
| + | <code javascript> | ||
| + | const grpc = require(' | ||
| + | const protoLoader = require(' | ||
| + | |||
| + | const def = protoLoader.loadSync(' | ||
| + | includeDirs: | ||
| + | keepCase: false, | ||
| + | longs: String, | ||
| + | enums: String, | ||
| + | defaults: true, | ||
| + | oneofs: true, | ||
| + | }); | ||
| + | const { apache } = grpc.loadPackageDefinition(def); | ||
| + | |||
| + | // 关键:这里填 Proxy 的 8081,不是 NameServer 的 9876 | ||
| + | const client = new apache.rocketmq.v2.MessagingService( | ||
| + | ' | ||
| + | grpc.credentials.createInsecure(), | ||
| + | { ' | ||
| + | ); | ||
| + | |||
| + | function send(body, tag, keys) { | ||
| + | return new Promise((resolve, | ||
| + | client.sendMessage({ | ||
| + | messages: [{ | ||
| + | topic: ' | ||
| + | systemProperties: | ||
| + | body: Buffer.from(body, | ||
| + | }], | ||
| + | }, (err, resp) => (err ? reject(err) : resolve(resp.entries))); | ||
| + | }); | ||
| + | } | ||
| + | |||
| + | send(' | ||
| + | .then(entries => console.log(JSON.stringify(entries))) | ||
| + | .catch(console.error); | ||
| + | </ | ||
| + | |||
| + | 动手前必须知道的几点: | ||
| + | |||
| + | * **Message 结构动过**:'' | ||
| + | * **心跳不能省**:官方 SDK 会周期性发 '' | ||
| + | * **消费端远比发送麻烦**:POP 消费要自己维持 '' | ||
| + | * **ACL**:开启鉴权后必须在 gRPC metadata 里带签名头(AK/ | ||
| + | * **升级代价**:官方 proto 不承诺向后兼容,Proxy 升级后自维护的 stub 可能要跟着改 —— 这正是路径 B 存在的理由。 | ||
| + | |||
| + | === 路径 B:Go / Python sidecar(生产推荐) === | ||
| + | |||
| + | 用官方 Go('' | ||
| + | |||
| + | < | ||
| + | Node 业务进程 | ||
| + | </ | ||
| + | |||
| + | * 好处:协议、心跳、重试、ACK、死信全交给官方 SDK,Node 只写业务;SDK 升级只动 sidecar,不用维护 proto stub。 | ||
| + | * 代价:多一个常驻进程,部署、监控、超时与错误透传要一起设计。 | ||
| + | * 什么时候值得:只要这条链路要进生产,就值得。团队里 Go / Java 更熟的话,投入产出比比在 Node 里手写协议高得多。 | ||
| + | |||
| + | 选型建议:多语言团队优先用 5.x 的 gRPC 客户端,接口在各语言间基本一致;**Node.js 没有官方客户端**,生产链路建议用 Go/Python sidecar 包住协议细节,而不是长期自己维护 gRPC stub;4.x 时代的 Python/Node 客户端维护活跃度较低,新项目不建议依赖。 | ||
| ===== 八、消息类型对照 ===== | ===== 八、消息类型对照 ===== | ||
| 行 579: | 行 654: | ||
| * 官方示例代码:https:// | * 官方示例代码:https:// | ||
| * 5.x 多语言客户端:https:// | * 5.x 多语言客户端:https:// | ||
| + | * gRPC 协议定义(proto,Node 自建客户端要取这里的文件):https:// | ||
| + | * Node.js 4.x 社区绑定(仅 remoting,连 9876,长期未更新):https:// | ||
| * Spring 集成:https:// | * Spring 集成:https:// | ||