GitHub user lulianqi created a discussion: 2026-11-14 Weekly

# DubboNet

RoadMap:以本帖的功能清单为本阶段讨论入口,后续通过对应 Issue / PR 持续跟踪。

阶段目标:扩大 .NET 应用接入范围,完善协议互通、服务治理接入与双语文档,在主要能力完成验收后推进正式 NuGet 发布。

> 本帖为 **2026-11-14 周会的议程与计划草案**,进展核对截至 
> **2026-11-12**。优先级、未认领任务的负责人、实现范围与发布窗口均待社区讨论确认,不代表已经形成周会决议。表中的作者仅表示已有 PR 
> 的贡献者,不预设其他人的工作承诺。

## Feature List

### 主干功能与演进计划

| task | owner | 等级(建议) | 进度 | issue/discussion | pr | review / 待确认 |
| --- | --- | --- | --- | --- | --- | --- |
| .NET Standard 2.0 兼容性迁移,保留 .NET 8 / .NET 10 原生产物 | lulianqi(PR 作者) | P1 | 
已提交,待评审与合并 | #11 | #39 | 兼容边界、回归结果及公共 CI |
| 以代码为唯一行为事实源的双语代码地图、RFC 与 Git 索引 | NeverENG(已有 PR);后续协作待认领 | P1 | 已有文档 
PR,待评审与范围对齐 | #32;关联 #16 的文档工作线 | #34 | 与合入代码同步,不建立第二份实现规范 |
| 原生二进制 Triple 协议支持 | 待认领 | P1 | 方案待讨论 | 待拆分 Issue | — | 首期调用模型、编码模式及运行时边界 |
| 客户端优先采用 Provider 声明的负载均衡策略 | 待认领 | P1 | 配置优先级待设计 | 待拆分 Issue | — | 方法级 / 
服务级优先级、未知策略回退与动态更新 |
| Consumer 默认注册与注册能力完整性核查 | 待认领 | P1 | 默认行为变更待评估 | 待拆分 Issue | — | 
应用身份、显式关闭、共享连接、恢复及注销可靠性 |
| 新增并持续维护 Apache Dubbo 官网的 .NET SDK 文档与导航 | 待认领 | P1 | 内容边界与提交路径待规划 | 待拆分文档 
Issue | — | 与仓库文档分工及中英文入口 |
| 正式 NuGet 发布准备 | Release Manager 及协作人员待社区确认 | 里程碑 | 等待主要能力验收 | 本帖发布准入清单 | — | 
版本、包标识、发布身份与社区发布流程 |

### 本周已推进的工作

- **兼容性迁移:** #39 已提出 `netstandard2.0;net8.0;net10.0` 多目标方案,保留 .NET 10 
SDK,不改变现有公开调用 API。该 PR 当前仍为 OPEN,不应表述为已经进入正式发布版本。
- **兼容验证:** #39 的本地完整单元测试已覆盖 .NET 8/10 × 原生/Standard 四种组合,每组 **602 项通过**;已补充 
`count` 与空项处理、Telnet 状态解析的显式回归用例。完整 Provider 方法端到端验证覆盖五种宿主/产物组合,每组 **156 
项通过**;流水线增加 .NET 10 → .NET 6 → .NET 8 顺序验证及实际 NuGet 消费检查。以上为本地验证记录,公共 
CI、Windows 执行和最终合并结论仍以 PR / Actions 为准。
- **双语文档:** #34 正在推进代码地图、协议说明、RFC 约定和 Git Changelog 索引;本阶段在已有工作上完善,不另起一套重复文档。
- **协作顺序:** 文档工作 #34 与模块归属重构 #36 需要协调。按现有 PR 
中约定的顺序推进,并在实现结构变化时同步更新两种语言的代码地图;不把未合入的结构当作当前主干事实。

## 重点议题与预期交付

### 1. .NET Standard 2.0 兼容性迁移

降低接入 DubboNet 时被迫升级整个应用的成本,同时保留现代运行时的原生实现。

- 完成 #39 的评审、必要回归与合并;确认 NuGet 中三个目标产物可被真实消费项目正确选择。
- 持续验证依赖链、超时、取消、资源释放、连接复用、注册中心及消费者注册行为。
- 文档明确区分“可引用”“已实际验证”和“尚未验证”。兼容较旧应用不等于延长其运行时的官方支持周期,也不自动承诺全部 .NET Framework / 
Nacos / HTTP/2 组合可用。

### 2. 代码驱动的双语文档与索引

降低新贡献者理解调用链、定位实现与验证行为的成本,让文档随代码演进。

- 延续 #32 / #34:代码地图解释“从哪里读、为什么看”,指向真实源码、符号和相关测试;不复制实现与默认值来维护第二份可能过期的事实。
- 保持中英文入口、模块地图、协议说明与导航对应,校验链接及实际代码归属。
- RFC 记录真实设计权衡与决定,并标明状态;Git / Issue / PR 跟踪开发过程;Changelog 作为可核验 Git 对象的索引,区分 
Unreleased 与已发布版本。
- 对外使用指南与内部代码地图分层,官网文档与仓库文档明确分工。

### 3. 原生二进制 Triple 协议支持

在现有经典 Dubbo TCP/Hessian2 与 Triple HTTP/JSON 能力之外,补齐原生二进制 Triple 调用路径。

- 以官方 [Triple 
协议规范](https://dubbo.apache.org/en/overview/reference/protocols/triple-spec/) 
为依据,讨论 HTTP/2、消息帧、编码模式、状态码与 metadata 的支持范围。
- 建议首期优先打通 Unary 互通,明确 Protobuf / IDL 与 Java Interface 包装模式的边界;Streaming 
是否进入首期需单独确认,不提前承诺完整 gRPC/流式能力。
- 补齐与 Java Provider 的互通、异常、超时/取消及连接复用测试;逐项确认各目标运行时的 HTTP/2 能力,保留现有调用路径。

### 4. Provider 优先的负载均衡策略

使客户端选择策略与服务端发布配置保持一致,减少多语言消费者之间的行为偏差。

- 以 **Provider 的有效策略声明优先于客户端缺省配置** 为设计方向;明确方法级与服务级配置的优先关系,以及显式客户端覆盖的边界。
- 对缺失、未知或尚未实现的策略提供确定的本地回退与可观察日志,不静默采用不支持的算法。
- 定义不同节点声明不一致、配置动态更新和存量客户端升级时的行为;区分“算法选择”与“节点权重”,增加相应测试。

### 5. Consumer 默认注册与能力核查

提高消费者在注册中心及管理平台中的可见性,同时保持 RPC 调用与注册生命周期的可靠性。

- 计划将默认行为调整为开启,并保留显式关闭;配置继续遵循共享注册中心的进程级管理方式,不引入相互冲突的 client 独立开关。
- **不只修改 `Enabled` 默认值。** 当前首次启用要求 
`ApplicationName`,需要先明确应用身份的配置/获取规则与初始化校验,避免已有应用因未提供名称而在启用时异常。
- 核查服务引用跟踪、注册元数据、去重、共享 client 引用计数、热切换、失败日志/重试、ZooKeeper 会话恢复、Nacos 
重连恢复,以及最后引用释放和进程退出时的注销。
- 验证临时节点/实例的失效清理与异常退出场景,以及只读权限、注册失败或网络异常时的降级。注册失败不应成为普通 RPC 调用的前置阻断。
- 上述为核查清单;哪些能力已具备、哪些确有缺失,以源码与测试结果为准,再拆分修复项,不预设“全部缺失”。

### 6. 官网 .NET SDK 文档建设与维护

让 .NET 开发者从 [Apache Dubbo 官网](https://cn.dubbo.apache.org/zh-cn/) 获得清晰、可信的接入入口。

- 新增或完善 .NET SDK 导航、快速开始、注册中心接入、协议选择、配置、兼容矩阵、排障和升级说明,并安排英文对应入口。
- 使用真实可运行示例,链接仓库中的实现、测试与代码地图;不将规划中的能力写成已支持,不把测试包当作正式版本推荐安装。
- 确认官网文档仓库的提交流程、页面归属和后续维护方式,随正式版本同步更新。

### 7. 正式 NuGet 发布

上述主要能力经评审和验收后,再进入正式发布阶段,不提前约定尚未确认的版本号或发布日期。

- 明确首个拟发布里程碑的范围,形成 Release Notes、兼容矩阵及升级说明。
- 核对包名/版本、发布账号与凭证管理、许可证和 NOTICE、发布产物及签名/校验材料。
- 遵循 Dubbo 社区及 [ASF 发布流程](https://www.apache.org/legal/release-policy.html) 
完成评审、验证和发布;NuGet 分发对应已批准的版本。

## 周会内容

### 1. 待讨论与确认

1. 确认本阶段功能范围、建议优先级、认领人与评审协作方式;未建 Issue 的任务如何拆分。
2. 确认 #39 的剩余评审与 CI 验证,以及 #34 / #36 的合入协调。
3. 确认二进制 Triple 首期范围、负载均衡配置优先级和 Consumer 默认注册的兼容策略。
4. 确认官网文档分工、正式版本准入标准及发布负责人的认领方式。

### 2. 行动项 / Action Items

| Action | Owner | Deadline | 验证方式 | 状态 |
| --- | --- | --- | --- | --- |
| 推进 #39 评审、公共 CI 与兼容边界确认 | lulianqi;评审协作待确认 | 待周会确认 | 评审结论、实际 CI 结果与合并记录 | 
Open |
| 对齐 #32 / #34 的文档交付及 #36 的代码地图同步 | 已有 PR 作者;后续协作待确认 | 待周会确认 | 双语入口/链接校验与对应源码核对 
| Open |
| 将 Triple、负载均衡和 Consumer 默认注册拆分为可验收的 Issue / 设计方案 | 待认领 | 待周会确认 | 
明确范围、配置语义、兼容风险与测试计划 | Open |
| 盘点消费者注册已有能力与实际缺口 | 待认领 | 待周会确认 | 逐项源码/测试证据,缺口单独跟踪 | Open |
| 确认官网 .NET SDK 文档入口与维护协作 | 待认领 | 待周会确认 | 官网文档提案或 PR,以及仓库链接关系 | Open |
| 整理正式版范围、稳定性问题分级与发布清单 | 发布协作人员待确认 | 待周会确认 | 发版准入清单及社区确认记录 | Open |

### 3. 风险与需要社区决策的事项 / Escalations

| 风险 / 待确认 | 影响 | 建议处理 |
| --- | --- | --- |
| Standard 可引用不等于所有旧运行时、注册中心和 HTTP/2 组合均可用 | 可能过度承诺兼容范围 | 按目标运行时与协议公布真实验证矩阵 |
| 原生二进制 Triple 与现有 HTTP/JSON 的支持边界未定义 | 范围膨胀或协议互通预期不一致 | 首期方案评审后再确定实现与发版范围 |
| Consumer 默认开启改变身份配置及注册中心写权限需求 | 可能影响已有应用启动、RPC 与退出清理 | 配套身份、显式关闭、降级、日志及生命周期测试 
|
| 文档与结构重构并行推进 | 中英文地图可能指向不同或尚未合入的实现 | 按 #34 / #36 约定协调,并随实际代码更新 |
| 现存稳定性问题仍需评估对发版的影响 | 新功能通过不等于适合正式发布 | 复核 #9(Hessian2 展开预算)与 #37(ZooKeeper 
watch/恢复重试),区分发版阻断和后续迭代 |

### 4. 发布准入清单(建议,待确认)

- [ ] 主要功能范围、行为变更与支持边界得到社区确认,对应实现完成评审与合并。
- [ ] 目标矩阵下的单元、真实 NuGet 消费及 Java Provider 端到端验证通过;所需平台的公共 CI 结果可追溯。
- [ ] Consumer 默认行为和负载均衡优先级有兼容/升级说明;稳定性问题已修复或有明确处置结论。
- [ ] 双语文档、索引、官网入口与拟发布代码/版本一致,示例可运行。
- [ ] 包标识、版本、发布身份、许可证/NOTICE、发布说明和社区发布流程准备完成。

建议推进顺序:**兼容基线与文档骨架 → 协议及配置语义落地 → 互通回归与官网同步 → 候选版本验收及正式发布**。具体排期、负责人和会后决议在讨论后补充。


GitHub link: https://github.com/apache/dubbo-net/discussions/40

----
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]

Reply via email to