GitHub user lulianqi created a discussion: 2026-11-21 Weekly
# DubboNet RoadMap:延续 [2026-11-14 Weekly](https://github.com/apache/dubbo-net/discussions/40) 的阶段计划,通过对应 Issue / PR 跟踪交付与验收。 阶段目标:扩大 .NET 应用接入范围,完善二进制协议互通、服务治理接入和双语文档,在主要能力完成验收后推进正式 NuGet 发布。 > 本帖为 **2026-11-21 周会议程与进展草案**,仓库状态核对截至 > **2026-11-21**。实现进展结合本周维护者同步;未合并能力不视为主干已支持,已合并也不代表已经发布。建议优先级、待认领事项、排期及发布窗口由社区讨论确认。 ## Feature List ### 主干功能与演进计划 | task | owner | 等级(建议) | 进度 | issue/discussion | pr | review / 待确认 | | --- | --- | --- | --- | --- | --- | --- | | .NET Standard 2.0 兼容性迁移,保留 .NET 8 / .NET 10 原生产物 | lulianqi(PR 作者) | P1 | **已合并**,进入持续回归与发布验收 | #11 | #39 | 兼容矩阵、真实包消费及各协议运行时边界 | | 以代码为唯一行为事实源的双语代码地图、RFC 与 Git 索引 | NeverENG(已有 PR);后续协作待认领 | P1 | **基础文档已合并**,后续随实现同步 | #32;关联 #16 | #34(已合并);#36(待合并) | 文档与代码路径、职责归属保持一致 | | 原生二进制 Triple 协议支持 | lulianqi(正在实现);协作见 #41 | P1 | **正在实现与验证** | #41 | 尚未提交关联 PR | 首期 Java 接口模式的二进制 Unary;本轮不包含 Protobuf/IDL | | 客户端优先采用 Provider 声明的负载均衡策略 | 待认领 | P1 | 待设计与拆分 Issue | 上周 RoadMap 延续 | — | 方法级/服务级优先级、显式覆盖、回退及动态更新 | | Consumer 默认注册与注册能力完整性核查 | 待认领 | P1 | 待能力盘点与兼容方案 | 上周 RoadMap 延续 | — | 应用身份、显式关闭、共享连接、热切换、恢复及注销 | | 新增并持续维护 Apache Dubbo 官网的 .NET SDK 文档与导航 | 待认领 | P1 | 待明确入口与内容分工 | 上周 RoadMap 延续 | — | 中英文接入指南、兼容矩阵与仓库文档的对应关系 | | 正式 NuGet 发布准备 | Release Manager 及协作人员待社区确认 | 里程碑 | 等待主要能力与稳定性验收 | 本帖发布准入清单 | — | 发布范围、包标识、版本及社区发布流程 | ### 本周已推进的工作 - **兼容性基线:** #39 已于 **11 月 16 日**合并,核心库提供 `netstandard2.0;net8.0;net10.0` 多目标产物。后续新能力需要延续兼容性验证;库可引用与具体宿主支持 HTTP/2 等能力应分别说明。 - **双语文档基线:** #34 已于 **11 月 13 日**合并,成为后续代码地图和索引维护的基础。#32 仍保持开放,后续文档整理与验收继续在该任务下跟踪。 - **二进制 Triple:** #41 已建立。本周实现同步明确:优先支持 **Java 接口模式的二进制 Unary 调用**,当前正在实现与验证;**本轮不支持 Protobuf/IDL,Streaming 后续另行讨论**。具体实现与互通结果待关联 PR 提交后评审。 - **Metadata / Registry 职责整理:** #36 仍未合并,已获得 Approve,现有行内讨论均已解决。最新提交 `ba439c3` 的三个工作流目前为 `action_required`,需要维护者批准运行;此前提交的绿灯不能替代最新提交的 CI 结果。 - **大型 Hessian2 响应:** #43 仍未合并,当前提交 `54df55d` 的构建、Framework 包兼容、端到端和许可证检查均已通过。PR 已补充大型响应边界与手动峰值内存探针,仍需评审者核对并收口讨论;不提前将 #9 标记为已完成。 - **后续需求池:** 新增 #42(etcd v3 注册发现与元数据中心)和 #44(Dubbo 3 应用级服务发现及应用元数据解析)。优先级、实现协作及是否纳入本阶段发布,由社区进一步讨论。 ## 重点议题与预期交付 ### 1. .NET Standard 2.0 兼容性迁移 兼容性迁移已进入主干,接下来重点是保持验证基线并准确描述支持范围。 - 持续维护 .NET Standard 2.0 / .NET 8 / .NET 10 产物与实际 NuGet 消费测试,保留现有多宿主端到端回归。 - 新增二进制 Triple 时,单独验证宿主的 HTTP/2、TLS/明文连接、取消及响应 trailer 能力;不因核心库可引用就推定所有旧宿主可用。 - 发布文档清楚区分已验证组合与尚未验证的组合。 ### 2. 代码驱动的双语文档与索引 - 延续 #32 / #34 的代码地图、RFC 与 Git 索引结构;文档指向实际源码及测试,随实现变化同步更新。 - #36 合入时再次核对中英文模块路径、方法名、状态所有者和订阅生命周期;以最终合入代码为准。 - 二进制 Triple 的新路径、配置入口和兼容边界随实现 PR 一并提供双语说明。 ### 3. 原生二进制 Triple 协议支持 本周重点从方案讨论进入 **实现与互通验证**,首期采用 Java 接口模式的 Unary。 - 基于 HTTP/2 打通消息帧、Java 参数序列化及框架 wrapper 的请求/响应链路,明确与现有调用入口和重载方法的关系。 - 验证 metadata、service group/version、`grpc-status` / `grpc-message` 和 trailers-only 错误;不能把 HTTP 200 单独当作 RPC 成功。 - 覆盖真实 Java Provider 互通、业务异常、超时、调用方取消、并发连接复用及取消隔离,并验证异常帧和载荷边界。 - 在可复现端到端环境中证明执行了二进制路径,保持经典 Dubbo TCP/Hessian2 和 Triple HTTP/JSON 回归通过。 - 清楚标明本轮不包含业务 Protobuf/IDL 与 Streaming;仅有 `tri://` 不能推定 Provider 支持全部编码模式,不在请求可能已执行后静默切换协议重发。 相关任务:#41。 ### 4. Provider 优先的负载均衡策略 - 明确方法级、服务级 Provider 声明与客户端配置的优先关系,以及显式客户端覆盖的边界。 - 设计未知策略、缺失配置、不同节点声明不一致及动态更新时的确定行为,补充相应回归。 - 将设计与验收拆分成独立 Issue,避免与二进制传输实现混在一起。 ### 5. Consumer 默认注册与能力核查 - 保留“默认开启”的演进方向,先核查应用名称等身份配置的兼容处理,避免仅调整 `Enabled` 默认值。 - 盘点共享注册中心配置、服务引用、去重、引用计数、热切换、失败日志与重试、会话/连接恢复及最后引用释放后的注销。 - 对照源码和测试区分已有能力与实际缺口;新增行为须有升级说明,注册失败不应成为普通 RPC 的前置阻断。 ### 6. 官网 .NET SDK 文档建设与维护 - 确认 [Apache Dubbo 官网](https://cn.dubbo.apache.org/zh-cn/) 的 .NET SDK 导航与中英文文档入口。 - 优先准备快速开始、注册中心接入、协议选择、兼容矩阵及排障说明,与仓库代码地图明确分工。 - 示例以实际可用版本和能力为准,发布时同步更新安装说明与版本边界。 ### 7. 正式 NuGet 发布 - 主要能力完成评审和验收后确定候选版本范围;本帖不提前承诺版本号或发布日期。 - 结合 #9 / #43、#37 等稳定性工作评估发布准入,区分必须修复项与后续迭代。 - 准备 Release Notes、升级指南、包标识与版本、许可证/NOTICE 核对,并按社区发布流程推进。 ## 周会内容 ### 1. 待讨论与确认 1. 确认 #41 首期范围与验证矩阵,安排实现 PR、协议评审和 Java Provider 互通验证。 2. 推进 #36 最新提交的工作流批准及运行;完成 #43 的边界和内存验证复核,收口评审讨论。 3. 确认 Provider 优先负载均衡、Consumer 默认注册的认领及独立 Issue 拆分。 4. 确认 #32 后续交付、官网文档分工,以及 #42 / #44 的需求优先级。 5. 明确本阶段发布范围与准入条件,再讨论版本及时间窗口。 ### 2. 行动项 / Action Items | Action | Owner | Deadline | 验证方式 | 状态 | | --- | --- | --- | --- | --- | | 推进二进制 Triple Unary 实现与验证,提交关联 PR | lulianqi;协作见 #41 | 待周会确认 | 设计说明、真实 Java Provider 互通、协议测试及 CI | In progress | | 保持多目标兼容及真实包消费回归 | 后续协作待认领 | 持续 | 多宿主/产物测试与实际 CI 记录 | Ongoing | | 批准并运行 #36 最新提交的工作流,确认结果后推进合并 | 有权限的维护者;PR 作者配合 | 待维护者安排 | 最新提交对应的构建、端到端及许可证检查 | Open | | 核对 #43 边界用例与内存探针,收口评审讨论 | PR 作者与评审者协作 | 待评审确认 | 测试/探针证据、评审结论和当前 CI | In review | | 拆分负载均衡配置优先级与 Consumer 默认注册任务 | 待认领 | 待周会确认 | 独立 Issue、配置语义、兼容说明与测试计划 | Open | | 确认双语文档后续整理及官网入口 | 待认领 | 待周会确认 | #32 验收及官网文档提案/PR | Open | | 盘点稳定性问题与正式发布清单 | 发布协作人员待确认 | 待周会确认 | #9 / #37 等问题的处置结论和发布准入记录 | Open | ### 3. 风险与需要社区决策的事项 / Escalations | 风险 / 待确认 | 影响 | 建议处理 | | --- | --- | --- | | 二进制 Triple 首期只覆盖 Java 接口 Unary | 使用者可能误以为包含业务 Protobuf/IDL 或 Streaming | 在 Issue、PR、双语文档和发布说明中保持一致边界 | | Standard 可引用与宿主 HTTP/2 能力不同 | 可能过度承诺旧运行时支持范围 | 按实际宿主、系统和协议公布验证矩阵 | | #36 更新提交后需重新批准工作流 | 历史 CI 通过不能证明最新提交可合并 | 针对当前提交完成检查后再合并 | | Hessian2 展开预算与并发内存成本 | 单次上限不等于整体进程内存上限 | 复核 #43 的边界及并发内存证据,文档说明限制 | | ZooKeeper 空节点 watch 与恢复刷新重试仍开放 | 可能影响 Provider 变化后的自动恢复 | 继续通过 #37 单独修复和验证 | | 治理配置默认值及新增发现需求尚待设计 | 可能扩大本阶段发布范围 | 先拆分任务并确认兼容策略、优先级与里程碑 | ### 4. 发布准入清单(建议,待确认) - [x] .NET Standard 2.0 / .NET 8 / .NET 10 多目标兼容改造已合并(#39)。 - [x] 双语代码地图、RFC 与 Git 索引的基础工作已合并(#34;后续工作仍由 #32 跟踪)。 - [ ] 二进制 Triple 首期范围明确,对应实现完成评审、互通和运行时验证,并合入主干。 - [ ] 负载均衡与 Consumer 注册的本阶段交付范围、兼容策略和验收结论得到社区确认。 - [ ] 最新代码的单元、真实包消费及 Java Provider 端到端公共 CI 通过,稳定性问题有明确处置结论。 - [ ] 双语文档、索引、官网入口及示例与候选版本一致。 - [ ] 发布范围、版本、包标识、发布协作、许可证/NOTICE 和社区发布流程准备完成。 后续进展、认领及会后决定在本帖或对应 Issue / PR 中补充。 GitHub link: https://github.com/apache/dubbo-net/discussions/45 ---- This is an automatically sent email for [email protected]. To unsubscribe, please send an email to: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
