差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
rocketmq [2026/10/16 14:11] – 导图:接入方式补上 Node.js 张叶安rocketmq [2026/10/16 14:11] (当前版本) – 参考小节补充 proto 与 nodejs 客户端链接 张叶安
行 457: 行 457:
 </code> </code>
  
-===== 七、接入方式四:Go / Python / C++ =====+===== 七、接入方式四:Go / Python / C++ / Node.js =====
  
 ^ 语言 ^ 4.x(remoting) ^ 5.x(gRPC) ^ ^ 语言 ^ 4.x(remoting) ^ 5.x(gRPC) ^
行 463: 行 463:
 | Python | ''pip install rocketmq-client-python''(C++ 内核) | apache/rocketmq-clients 的 python 目录(gRPC,需自行装 grpcio 依赖) | | Python | ''pip install rocketmq-client-python''(C++ 内核) | apache/rocketmq-clients 的 python 目录(gRPC,需自行装 grpcio 依赖) |
 | C++ | ''rocketmq-client-cpp'' | ''rocketmq-client-cpp'' 的 5.x 分支(gRPC) | | C++ | ''rocketmq-client-cpp'' | ''rocketmq-client-cpp'' 的 5.x 分支(gRPC) |
-| Rust / Node | 社区客户端居多 | 官方 gRPC 客户端或社区包,随 5.x 生态 |+| Rust | ''rocketmq-client-rust''(4.x 内核) | ''rocketmq-client-rust'' 的 5.x 分支(gRPC) | 
 +| Node.js | ''rocketmq-client-nodejs''(C++ 绑定,连 9876,已少维护) | **无官方客户端**:用 ''@grpc/grpc-js'' 自行直连 Proxy,或走 Go/Python sidecar(见下) |
  
 Go(4.x 风格): Go(4.x 风格):
行 520: 行 521:
 </code> </code>
  
-选型建议:多语言团队优先用 5.x 的 gRPC 客户端,接口在各语言间基本一致;4.x 时代的 Python/Node 客户端维护活跃度较低,新项目不建议依赖。+== Node.js 接 5.x gRPC:官方没客户端,两条路 == 
 + 
 +先把现状说清楚:官方 ''rocketmq-clients'' 覆盖 Java / C++ / C# / Go / Rust / Python 等语言,**Node.js 一直是个空缺**;能搜到的 ''rocketmq-client-nodejs'' 是 4.x 时代的 C++ 绑定(连 NameServer 9876,走 remoting),早已停止更新,接不了 5.x Proxy。所以 Node 侧只有下面两条路。 
 + 
 +=== 路径 A:用 @grpc/grpc-js 直连 Proxy 的 8081 === 
 + 
 +原理:Proxy 对外暴露的就是标准 gRPC 服务 ''apache.rocketmq.v2.MessagingService'',只要有官方 proto,Node 自己也能当客户端。 
 + 
 +<code bash> 
 +npm i @grpc/grpc-js @grpc/proto-loader 
 + 
 +# 从 apache/rocketmq-clients 仓库把 proto 目录拷到本地,例如: 
 +#   proto/apache/rocketmq/v2/definition.proto 
 +#   proto/apache/rocketmq/v2/service.proto 
 +</code> 
 + 
 +<code javascript> 
 +const grpc = require('@grpc/grpc-js'); 
 +const protoLoader = require('@grpc/proto-loader'); 
 + 
 +const def = protoLoader.loadSync('proto/apache/rocketmq/v2/service.proto', { 
 +  includeDirs: ['proto'], 
 +  keepCase: false,        // 生成驼峰方法名 sendMessage / receiveMessage 
 +  longs: String, 
 +  enums: String, 
 +  defaults: true, 
 +  oneofs: true, 
 +}); 
 +const { apache } = grpc.loadPackageDefinition(def); 
 + 
 +// 关键:这里填 Proxy 的 8081,不是 NameServer 的 9876 
 +const client = new apache.rocketmq.v2.MessagingService( 
 +  '192.168.1.10:8081', 
 +  grpc.credentials.createInsecure(),       // 托管版 / 开 TLS 时换成 createSsl(...) 
 +  { 'grpc.keepalive_time_ms': 30000, 'grpc.keepalive_timeout_ms': 10000 } 
 +); 
 + 
 +function send(body, tag, keys) { 
 +  return new Promise((resolve, reject) => { 
 +    client.sendMessage({ 
 +      messages: [{ 
 +        topic: 'topic_order',                 // 字段名请以你手上的 proto 为准 
 +        systemProperties: { tag, keys },      // tag / keys 属于系统属性 
 +        body: Buffer.from(body, 'utf8'), 
 +      }], 
 +    }, (err, resp) => (err ? reject(err) : resolve(resp.entries))); 
 +  }); 
 +} 
 + 
 +send('{"orderId":"A1001"}', 'PAID', 'A1001') 
 +  .then(entries => console.log(JSON.stringify(entries))) 
 +  .catch(console.error); 
 +</code> 
 + 
 +动手前必须知道的几点: 
 + 
 +  * **Message 结构动过**:''topic'' / ''tag'' / ''keys'' 是顶层字段还是塞在 ''systemProperties'' 里,5.0 前后调整过,务必对着本地 proto 文件核对字段名,不要照抄旧博客。 
 +  * **心跳不能省**:官方 SDK 会周期性发 ''TelemetryCommand''(上报 settings、线程栈)和 ''Heartbeat''。只调 ''SendMessage'' 在部分版本上看着能用,但 Proxy 会把没有存活信号的连接当异常客户端清理,表现为随机超时、偶发失败,生产环境务必补齐。 
 +  * **消费端远比发送麻烦**:POP 消费要自己维持 ''ReceiveMessage'' 长轮询、调 ''AckMessage''、管理不可见时间(invisibleDuration)与重试/死信,还要处理连接重建。手写这一套性价比很低。 
 +  * **ACL**:开启鉴权后必须在 gRPC metadata 里带签名头(AK/SK 按官方 SDK 的签名算法算),否则 Proxy 直接拒绝请求。 
 +  * **升级代价**:官方 proto 不承诺向后兼容,Proxy 升级后自维护的 stub 可能要跟着改 —— 这正是路径 B 存在的理由。 
 + 
 +=== 路径 B:Go / Python sidecar(生产推荐) === 
 + 
 +用官方 Go(''github.com/apache/rocketmq-clients/golang/v5'')或 Python 客户端跑一个极小的网关进程,对外只暴露 HTTP / gRPC,Node 侧调网关: 
 + 
 +<code> 
 +Node 业务进程  --HTTP/gRPC-->  sidecar(官方 Go/Python 客户端)  --gRPC 8081-->  Proxy 
 +</code> 
 + 
 +  * 好处:协议、心跳、重试、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://github.com/apache/rocketmq/tree/develop/example   * 官方示例代码:https://github.com/apache/rocketmq/tree/develop/example
   * 5.x 多语言客户端:https://github.com/apache/rocketmq-clients   * 5.x 多语言客户端:https://github.com/apache/rocketmq-clients
 +  * gRPC 协议定义(proto,Node 自建客户端要取这里的文件):https://github.com/apache/rocketmq-clients/tree/master/proto
 +  * Node.js 4.x 社区绑定(仅 remoting,连 9876,长期未更新):https://github.com/apache/rocketmq-client-nodejs
   * Spring 集成:https://github.com/apache/rocketmq-spring   * Spring 集成:https://github.com/apache/rocketmq-spring
  
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • rocketmq.1792131078.txt.gz
  • 最后更改: 2026/10/16 14:11
  • 由 张叶安