lulianqi opened a new issue, #41: URL: https://github.com/apache/dubbo-net/issues/41
## 背景 承接 [2026-11-14 Weekly](https://github.com/apache/dubbo-net/discussions/40) 中“原生二进制 Triple 协议支持”的计划。 当前主干的 `TripleDubboActuatorSuite` 已支持 Java Interface Unary HTTP/JSON 调用;README 明确说明 Protobuf/IDL、gRPC 消息帧和 Streaming 尚未实现。希望在保留现有经典 Dubbo TCP/Hessian2 与 Triple HTTP/JSON 能力的基础上,增加原生二进制 Triple 调用路径。 本 Issue 中的“原生二进制 Triple”指基于 HTTP/2、符合 Triple 扩展 gRPC 子协议的帧化 RPC 调用,不是仅将 HTTP 版本改为 2.0,或仅把 JSON 请求体替换成二进制数据。 ## 必要性与价值 - 扩大可接入的 Triple Provider 范围,不再局限于当前 Java Interface HTTP/JSON 路径。 - 为 Protobuf/IDL 及 Java Interface 包装模式的互通建立明确的编码与契约边界,减少跨语言调用的歧义。 - 正确处理消息帧、metadata、trailer 和 RPC 状态,为后续流式能力打好基础。 - 尽量复用现有服务发现、服务驱动和调用入口,避免让使用者为新增传输能力重写已有调用逻辑。具体性能收益应通过测试验证,不提前承诺。 ## 建议范围 ### 1. 首期优先支持 Unary 建议先完成一请求一响应的二进制 Unary 调用,再按独立任务评审 Streaming。 编码/契约模式需在实现前形成设计结论: - 明确首期是否支持 Protobuf/IDL(如 `application/grpc+proto`)、Java Interface 包装模式(如 `application/triple+wrapper`),以及各自需要的消息类型、方法签名和序列化信息。 - 说明与现有 `QueryAsync` / `DubboInvocation`、泛化调用及重载方法的关系。若首期只覆盖其中一种模式,应明确限制,不能据此宣称支持另一种模式或全部 Triple 服务。 - 不预设必须自行实现 HTTP/2;评估现有 .NET HTTP/gRPC 能力及依赖的适配成本,优先复用成熟实现。 ### 2. 协议正确性与资源生命周期 - 实现并验证消息封装、长度/压缩标志、请求与响应 metadata,以及 trailer 中的 `grpc-status` / `grpc-message`;不能将 HTTP 200 直接视为 RPC 成功,也应正确处理 trailers-only 错误响应。 - 保持 service version/group 等路由信息;明确二进制 metadata 的编码方式、未知编码和不支持压缩的处理策略。 - 保持覆盖完整调用的 deadline 与调用方取消语义;取消单次调用不能误伤共享连接上的其他请求。 - 明确连接复用、并发调用、异常断连、释放及后续请求恢复的行为,不自动重放结果不确定的业务请求。 - 对非法/截断消息、异常长度、过大载荷及解码资源消耗设置边界;协议错误应可诊断,不能导致无界等待或分配。 ### 3. 与现有能力及目标框架协同 - 保留已有 Dubbo TCP/Hessian2 和 Triple HTTP/JSON 路径,不将本任务变成现有公开调用 API 的整体重设计。 - 明确 Provider 能力、配置与传输模式的选择规则;仅有 `tri://` 不能证明所有编码模式均可用。不得在请求可能已执行后静默切协议重发。 - 与 #11 / #39 的多目标兼容工作协调,按运行时、操作系统、HTTP/2 及所选依赖公布验证矩阵。`netstandard2.0` 可引用不等于所有旧宿主均能运行该传输。 - 不支持的环境或模式应给出明确错误及文档说明,不能无提示地将二进制调用降为 HTTP/JSON。 ## 测试与验收标准 - [ ] 形成可评审的设计说明,明确首期调用模型、编码/契约模式、传输选择规则、API 影响和兼容边界。 - [ ] 对已声明支持的模式,与真实 Java Triple Provider 完成 Unary 请求/响应互通,包括数据类型、路由信息和预期业务异常。 - [ ] 单元/协议测试覆盖分片读取、帧边界、异常长度、trailer 状态和 trailers-only 错误;测试不能仅依赖生产编码器生成自身的断言依据。 - [ ] 覆盖超时、调用方取消、并发复用、取消隔离、异常断连和资源释放,且不通过自动业务重试掩盖失败。 - [ ] 在现有可复现端到端环境中补充 Provider/用例及 CI,明确证明执行了二进制 Triple 路径,而非现有 HTTP/JSON 路径。 - [ ] 已有经典 Dubbo、Triple HTTP/JSON、注册发现和元数据相关测试持续通过,不删除或跳过原有用例来达标。 - [ ] 按实际支持范围完成运行时和依赖验证,并同步中英文文档、示例与协议能力矩阵;未验证能力明确标注。 ## 暂不默认纳入首期 客户端流、服务端流、双向流、完整 gRPC 生态兼容、服务端实现,以及与本功能无关的治理重构。是否纳入后续里程碑,由社区另行确认;本 Issue 不预设负责人、发布日期或发版版本号。 ## 参考 - [Triple 协议规范](https://dubbo.apache.org/en/overview/reference/protocols/triple-spec/) - [当前 README 的兼容性说明](https://github.com/apache/dubbo-net#compatibility) - [2026-11-14 Weekly](https://github.com/apache/dubbo-net/discussions/40) - #11、#39:目标框架兼容工作,不能替代本协议的实际运行时验证。 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
