NeverENG opened a new issue, #44:
URL: https://github.com/apache/dubbo-net/issues/44

   ## 问题与现状
   
   当前 DubboNet 的消费端主要使用接口级服务发现:通过接口名获取 ZooKeeper `providers` 节点或 Nacos 中对应的 
Provider 实例,将注册信息解析为服务端点,再交给 Driver 选择与调用。
   
   现有 metadata 能力主要读取方法和类型定义(如 `FullServiceDefinition`),用于 Java 
签名推断、重载匹配及类型解析;它不等同于 Dubbo 3 应用级发现所需的应用元数据 `MetadataInfo`。
   
   因此,能够调用提供接口级注册记录的 Dubbo 3 Provider,并不能证明支持应用级服务发现。对于仅启用应用级注册的 
Provider,目前缺少接口到应用映射、应用实例订阅、按 revision 获取应用元数据及还原服务端点的完整链路。
   
   ## 目标
   
   增加消费端的 Dubbo 3 应用级服务发现能力:
   
   ```text
   接口名
     → 接口到应用的 mapping(或显式指定应用)
     → 应用实例订阅
     → 读取实例声明的 metadata revision、存储类型及访问能力
     → 获取对应应用元数据
     → 应用实例 + 服务元数据还原 Provider 端点
     → 交给现有 Driver 选择与调用
   ```
   
   支持的 Java Dubbo 版本、注册中心、metadata 存储模式及访问协议需要在设计阶段明确,按实际互通验证公布支持矩阵。
   
   ## 建议设计范围(待讨论)
   
   ### 1. 发现模型与兼容策略
   
   - 明确接口级与应用级发现的选择方式、配置、默认行为及迁移策略;是否支持双模式与去重应单独定义。
   - 获取并监听 interface → application mapping,支持显式应用配置;处理 mapping 新增、移除及订阅失败。
   - 订阅应用实例,解析实例发布的 revision、metadata 存储类型、访问版本及协议端口信息。
   - 还原端点时保留 interface、group、version、protocol 和路由参数,处理同应用多实例、多协议及实例移除。
   
   ### 2. 应用元数据与现有 metadata 的边界
   
   - 区分应用级 `MetadataInfo` 与接口方法/类型定义,明确各自模型、缓存和消费方。
   - 定义 remote metadata report 与 Provider 本地 MetadataService RPC 
的支持范围、能力协商和回退条件,核对真实 Java wire contract。
   - 缓存键需要考虑 registry/metadata backend、应用及 revision 
的隔离,避免跨应用或跨后端串用;失败结果不能作为永久成功缓存。
   - Registry 负责发现及变化通知,Metadata 负责应用元数据读取/解析与缓存;端点交给现有 Driver,避免增加第二份可调用 
Provider 候选状态。具体接口归属在设计中确认。
   
   ### 3. 错误契约与恢复生命周期
   
   - 
使用可识别的错误分类和结构化上下文,区分成功空结果、暂时读取失败、无效元数据、配置/认证错误及取消/释放,保留底层原因;不依赖错误文案决定清空候选或重试。
   - 明确各类失败的重试持有者、预算或持续恢复条件、退避和去重规则;避免 SDK、metadata、发现层叠加无界重试。
   - 初次订阅或 metadata 获取失败后,即使没有新的注册中心事件,也应有明确的恢复路径;订阅恢复后重新同步当前快照。
   - 处理实例/revision 变化、退订和释放:旧任务不得复活已删除实例或覆盖较新结果,退出后停止重试。
   - 定义部分实例元数据失败时的端点更新策略,明确“确认没有端点”与“当前无法确认状态”的区别。
   
   ## 验收条件
   
   - [ ] 形成可评审的设计,明确首期支持矩阵、配置兼容性、模块边界及失败恢复契约。
   - [ ] 在可复现环境中运行真实 Java Dubbo Provider,**仅启用应用级注册**;确认无接口级 Provider 记录仍可完成发现和 
RPC 调用。
   - [ ] 验证真实 mapping、实例声明、revision 及应用元数据的读取和解析,而非仅构造 URL 或用 fake 替代整条链路。
   - [ ] 覆盖同应用多实例、接口/group/version/protocol 匹配,以及实例、mapping 和 revision 的动态变化。
   - [ ] 覆盖 metadata/订阅首次失败且无后续事件时的恢复,以及断线重连、退订/释放、迟到结果、并发请求和缓存隔离。
   - [ ] 为确定性错误分支增加离线测试,现有接口级发现、方法/类型定义读取和 RPC 回归测试保持通过。
   - [ ] 更新中英文说明和兼容矩阵,仅对实际验证的组合声明应用级发现支持。
   
   ## 范围边界与关联
   
   本 Issue 跟踪消费端应用级发现,不要求同时建设 .NET Provider 服务端、服务导出、应用实例发布或完整 metadata 
写入系统。后续若需要这些能力,应另行定义真实调用方及发布生命周期。
   
   这是新的发现能力及恢复契约设计,独立于 #35 / #36 的模块归属重构。与 #37 的恢复问题、#42 的 etcd 
适配协调,避免重复实现或对尚未验证的后端作出支持承诺。
   
   参考资料(历史讨论与当前实现需要分别核对,不直接作为已接受的实现规范):
   
   - [dubbo-go #3300:metadata 
全链路讨论](https://github.com/apache/dubbo-go/discussions/3300)
   - [dubbo-go #3342:Metadata 
设计与审查](https://github.com/apache/dubbo-go/discussions/3342)
   - [dubbo-go #3188:metadata 
报告及删减历史复盘](https://github.com/apache/dubbo-go/issues/3188)
   


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

Reply via email to