Qianlin1455 opened a new issue, #3792:
URL: https://github.com/apache/dubbo-go/issues/3792

   # [Audit] Dubbo-Go v3.3.0 与 Dubbo Admin Generic Invoke 对齐及调用示例审计汇总
   
   ## 背景与目标
   
   针对 **Dubbo-Go v3.3.0 ↔ Dubbo Admin** 的功能对齐,以及 Admin **Generic Invoke 
调用示例完整性**,对两个仓库进行了独立源码审计及有限范围的测试验证。本 Issue 
将两份审计结果合并为一份**可追踪的审计汇总与后续任务清单**,供维护者确认优先级、归属仓库及回归验收范围。
   
   > 本 Issue 是审计/跟踪 Issue,**不是**声明所有问题均发生于最新 Dubbo-Go 或已完成真实跨语言 E2E。既有功能需求以 
[dubbo-go #3742](https://github.com/apache/dubbo-go/issues/3742) 
为主,已有修复/测试不应重复提交。
   
   ### 固定审计基线
   
   | 对象 | 版本 / commit | 说明 |
   | --- | --- | --- |
   | Dubbo-Go | `v3.3.0` / 
[`012a247993ba63a9e9033761c85ac9ccc950c594`](https://github.com/apache/dubbo-go/commit/012a247993ba63a9e9033761c85ac9ccc950c594)
 | 被审计的历史正式标签,不等于当前 `main` |
   | Dubbo Admin | `develop` / 
[`0db71b07b9d94b2f57e3ffd22af5e55e6083e63f`](https://github.com/apache/dubbo-admin/commit/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f)
 | **2026-11-04** 取得的源码快照,不代表后续所有 develop 变更 |
   | Admin 内嵌 Dubbo-Go SDK | `v3.0.0-20260210015753-35ea886421f9` | Admin 
实际依赖,**不是** v3.3.0;不能直接强制换成 v3.3.0 |
   
   ### 总体结论
   
   1. **Admin 已存在真实 Generic Invoke UI → HTTP → Service → SDK 调用链**,不应再描述成“只有静态 
UI”。但缺乏可重复执行的用户调用文档、正确的部分 UI 示例与真实 Provider E2E 证据。
   2. **确认四项主要功能问题(针对上述固定版本)**:Admin 的整数精度丢失和错误语义丢失;Dubbo-Go v3.3.0 的条件路由 flag 
读取颠倒与标签规则应用名查找不一致。
   3. 另有 **两项已确认的示例缺陷**(`char` 默认模板和 Boolean 返回 mock 不匹配)、SDK 版本/API 
替换约束,以及若干尚待真实环境验证的元数据/协议问题。这些事项**不能混算成新增已复现的网络兼容 Bug**。
   4. Admin 最新审计快照已能正确写出 `enabled/force/runtime=false`,不再将旧版 false flag writer 
问题计入本次缺陷。
   
   ## A. Dubbo Admin 调用示例与文档缺口
   
   | 优先级 | 状态 | 具体问题 / 证据 | 建议 |
   | --- | --- | --- | --- |
   | P0(示例正确性) | Confirmed | 
[`debug.vue:423`](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/ui-vue3/src/views/resources/services/tabs/debug.vue#L423)
 为 `char`/`Character` 生成空字符串,而 
[`decodeCharRaw`](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/pkg/console/service/service_generic_invoke_decode.go#L167)
 要求单字符 | 默认值改为单字符(例如 `"a"`),补实际 metadata 对应的调用示例 |
   | P1 | Confirmed | [`service.ts` 
mock](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/ui-vue3/src/mocks/handlers/service.ts#L128)
 声明 `create/delete → Boolean`,但 [Generic Invoke 
mock](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/ui-vue3/src/mocks/handlers/service.ts#L254)
 固定返回 User 对象;method detail mock 未按 signature 精确区分重载 | 按 method/signature 
返回匹配的示例结果,不把 mock 作为真实 RPC 通过证据 |
   | P1 | Gap | README/docs 未找到覆盖 Generic Invoke 
的集中使用说明;无参、单参、多参、数组、重载、基本类型/对象返回、常见错误的完整示例不足 | 补一份从登录、发现实例和方法到 POST 
请求/响应的端到端使用指南 |
   | P1 | Gap | 未找到上游快照中的 Generic Invoke 专项 Handler/wire/Java-Go Provider E2E | 
补真实可重放的 Provider fixture 和专项测试;与 #3742 的测试模块协调 |
   | P2 | Boundary | `null`、primitive/boxed、Enum、Map/List、嵌套对象、long、其他 generic 
mode 的支持范围未集中写明 | 只记录经过代码或 Provider 验证的行为,不把未接入的模式写成已支持 |
   
   **建议的最小文档契约**:
   
   - 调用链:`GET /api/v1/service/provider-instances` → `GET 
/api/v1/service/methods` → `GET /api/v1/service/method/detail` → `POST 
/api/v1/service/generic/invoke`(受登录认证保护)。
   - 说明 `mesh / serviceName / instanceName / methodName / signature / group / 
version / args / timeoutMs / attachments` 的含义与约束。
   - `instanceName` 使用发现的实例名,`signature` 复制实际 provider metadata,`group/version` 
在发现与调用时一致。
   - `args` 是**参数列表**:无参 `[]`;一个数组参数 `[[1,2]]`。UI 编辑器的 `args` **不是**完整 HTTP 
body。
   - `timeoutMs <= 0` 默认归一为 3000ms;附件为 string-to-string map;实际跨协议传播仍需 E2E。
   - 当前 develop 错误 envelope 为 `code/message/data`,不要提前照搬未合入 #1605 的 
`field/expected/actual` 扩展。
   - 区分 **Dubbo/Triple 协议**、**Hessian2 序列化** 和 **generic mode**;当前 Admin HTTP 
DTO 没有可直接选择其他 generic mode 的字段。
   
   ## B. 已确认的对齐问题(固定版本)
   
   ### B1. Admin 数字解码导致精度丢失(P1 / Confirmed)
   
   - **现象**:`long=9.007199254740993e15` 解码成 `9007199254740992`;Bean 
`{"id":9007199254740993}` 的嵌套整数同样舍入。作为对照,十进制整数字面量的顶层 `long` 在测试中可精确解码。
   - **根因**:科学计数法解析经 `float64` 中转;嵌套对象的 `json.Unmarshal(any)` 未按 metadata 
递归保留整数精度;UI `JSON.parse` 也可能提前舍入。
   - **位置**:[Admin 
decoder](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/pkg/console/service/service_generic_invoke_decode.go#L199)、[整数解析](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/pkg/console/service/service_generic_invoke_decode.go#L238)、[UI](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/ui-vue3/src/views/resources/services/tabs/debug.vue#L558)。
   - **建议**:顶层 scalar long 的精确解析优先复用 **[Admin PR 
#1605](https://github.com/apache/dubbo-admin/pull/1605)**;嵌套 Bean/Map/数组精度与 UI 
大整数输入另行按 #3742 协调。覆盖 `2^53 ± 1`、`int64` 边界、指数形式及字段路径错误。
   
   ### B2. Admin 丢失 RPC 超时/业务异常类型(P2 / Confirmed)
   
   - **现象**:Service 接收到 `context.DeadlineExceeded` 或 SDK 
`hessian2.GenericException` 后,统一生成 `InternalError: generic invoke failed, 
please check server logs`,调用方无法区分错误类别。
   - **位置**:[Admin 
`service_generic_invoke.go`](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/pkg/console/service/service_generic_invoke.go#L178)。
   - **建议**:在 Service/Handler 保留并分类 
`timeout/cancel/业务异常/序列化/网络错误`;在安全边界内展示可诊断信息并保持日志。与 #3742 的错误/结果模块协调。
   - **验证范围**:Service 层替换 RPC 边界完成观察测试,**没有**实际通过 Java Provider 抛出异常的网络 E2E。
   
   ### B3. Dubbo-Go v3.3.0 条件路由 enabled/force 读取颠倒(P1 / Confirmed for v3.3.0)
   
   - **现象**:`enabled=true, force=false` 实际读取为 `enabled=false, 
force=false`;`enabled=false, force=true` 被读取成 `enabled=true, force=false`。
   - **位置**:[v3.3.0 
`dynamic_router.go:254`](https://github.com/apache/dubbo-go/blob/012a247993ba63a9e9033761c85ac9ccc950c594/cluster/router/condition/dynamic_router.go#L254)。
   - **建议**:核对后续分支/维护版本是否已经修复,必要时决定 v3.3.0 回补;加入四种布尔组合与实际流量选择验证。
   - **相关跟踪**:[dubbo-go 
#3768](https://github.com/apache/dubbo-go/issues/3768)、[PR 
#3773](https://github.com/apache/dubbo-go/pull/3773)。这些历史条目已关闭,但**仅凭关闭状态不推断本项已修复**。
   
   ### B4. Dubbo-Go v3.3.0 标签规则订阅和读取使用不同应用名(P1 / Confirmed for v3.3.0)
   
   - **现象**:规则按 Provider application 订阅,而路由时从 Consumer URL 查 
app;两者异名时缓存规则可能无法命中。已观察到 2 个 Provider 均被选中,对照传 Provider app 时仅选中 1 个。
   - **位置**:[v3.3.0 
`tag/router.go`](https://github.com/apache/dubbo-go/blob/012a247993ba63a9e9033761c85ac9ccc950c594/cluster/router/tag/router.go#L56)、[`RegistryDirectory.List`](https://github.com/apache/dubbo-go/blob/012a247993ba63a9e9033761c85ac9ccc950c594/registry/directory/directory.go#L466)。
   - **建议**:统一 Provider application 的规则 key,检查同名/异名、多个 Provider app、更新、删除和 
force/fallback;复用已有兼容测试。
   - **相关跟踪**:[dubbo-go 
#3769](https://github.com/apache/dubbo-go/issues/3769)、[PR 
#3772](https://github.com/apache/dubbo-go/pull/3772)。同样需核对其覆盖范围和适用版本。
   
   ## C. 待验证的跨仓库契约(不要直接当作已确认 Bug)
   
   | 项目 | 审计状态 | 后续验收 |
   | --- | --- | --- |
   | Admin → Go v3.3.0 Provider 的 Dubbo / Triple unary 泛化调用 | Not Verified | 
启动真实 Provider + Nacos/ZooKeeper,抓取方法 metadata、发出请求并核对结果/wire |
   | Provider interface metadata、revision 更新及方法可见性 | Potential Gap | 区分应用级 
`MetadataInfo` 与 Admin 所需的 `canonicalName/methods/types`,验证新增/更新/删除 |
   | HTTP 客户端断开后的 RPC 取消 | Potential Gap | 测试 HTTP request context 是否传播到真实 
RPC;避免仅依据静态分析下最终结论 |
   | 复杂类型、Enum、Map/List、数组、重载、attachments 与异常跨语言表现 | Not Verified | 用真实 Java/Go 
Provider 测试,明确 protocol/mode 支持范围 |
   | Admin SDK 直接替换为官方 Go v3.3.0 | Confirmed **API/build constraint**,不是默认部署 
Bug | 临时 modfile 替换因缺少 `protocol/base` 等构建失败;不能据此推导两端不同 SDK 的网络互操作必然失败 |
   
   ## D. 已有工作与不重复范围
   
   - **[dubbo-go 
#3742](https://github.com/apache/dubbo-go/issues/3742)**:泛化模式、wire/API 
校验、类型转换、typed result/异常、真实跨仓库 E2E 的既有总任务。
   - **[dubbo-admin PR 
#1605](https://github.com/apache/dubbo-admin/pull/1605)**:参数/wire 校验、scalar 
long 精确解析、结构化错误及对应测试;**2026-11-06 核对仍为 Open**,不能把其变更写成已存在于所审计的上游 develop。
   - **[dubbo-go #3768](https://github.com/apache/dubbo-go/issues/3768) / 
[#3769](https://github.com/apache/dubbo-go/issues/3769)** 与 **[PR 
#3773](https://github.com/apache/dubbo-go/pull/3773) / 
[#3772](https://github.com/apache/dubbo-go/pull/3772)**:已有治理测试/修复相关工作;先检查已包含哪些场景及是否需历史版本回补,避免新建重复修复任务。
   - Admin 当前审计快照的 false flag writer 已通过 writer → Go parser 的边界测试,不重复报旧版 writer 
Bug。
   
   ## E. 测试记录与限制
   
   **已执行(独立源码快照、未修改业务工作区):**
   
   - Admin `go test ./pkg/console/model ./pkg/console/service 
./pkg/console/handler ...`:model/service 通过;handler 在 
`TestObservabilityInstanceDashboardDispatch/metric` 失败(期望 `10.42.1.10:22222`,实际 
`10.42.1.10`),**属于另一个 Observability 测试问题**,不作为 Generic Invoke 失败证据。
   - Admin 临时审计测试:大整数解码与错误映射的观察断言通过;Node JSON.parse 精度重放符合观察结果。
   - Dubbo-Go v3.3.0 临时审计测试:条件/标签路由原始算法行为及规则 writer/parser 边界的观察断言通过。**观察测试 
PASS 表示成功复现所描述行为,不表示产品功能正常。**
   - Admin 使用临时 modfile 替换为正式 v3.3.0 SDK 的构建实验失败;这仅说明版本/API 约束。
   
   **未执行:** 真实 Java/Go Provider + Nacos/ZK 的完整 Admin 网络调用、Dubbo/Triple E2E、真实 
RPC 取消与异常传播、浏览器 UI E2E、规则增改删实际流量验证。因此这些内容只能标为 `Not Verified`。
   
   ## F. 建议的行动项 / 验收清单
   
   - [ ] **Admin(示例)** 修正 char/Character 默认模板及 Boolean mock,补齐 method/signature 
匹配。
   - [ ] **Admin(文档)** 新增 Generic Invoke 
完整调用指南和示例,覆盖认证、发现、signature、args、数组、timeoutMs、attachments 和真实响应。
   - [ ] **Admin(数据)** 对照 #1605 合入状态处理 scalar long,并单独验收嵌套对象/集合的大整数无损处理。
   - [ ] **Admin(错误)** 按 #3742 规划 timeout、GenericException、序列化/网络错误的分类与 UI 展示。
   - [ ] **Dubbo-Go(治理)** 核对 B3/B4 在后续版本中的修复情况,决定是否需要 v3.3.0 维护分支 backport。
   - [ ] **双仓库(元数据)** 以真实 Go v3.3.0 Provider 验收实例发现、方法/类型 metadata、revision 更新与 
group/version。
   - [ ] **双仓库(互操作)** 建立 Java/Go × Dubbo/Triple(仅实际支持的 
unary/mode)可重放测试矩阵;报告成功结果与未支持边界。
   - [ ] **维护者确认**:Issue 应拆分的修复仓库、支持版本、已有 PR 复用范围及优先级。
   
   ## 相关资料与请求
   
   详细代码依据见本 Issue 上方各源码固定 SHA 链接。请维护者确认:
   
   1. 是否以本 Issue 作为**审计与验收总跟踪**,由现有 #3742/已有 PR 和必要的子 Issue 承担代码修改?
   2. Go v3.3.0 的两项治理问题是否需要回补,还是仅保证更新版本已修复并明确升级路径?
   3. 对 Admin → Go v3.3.0 Provider,优先验证哪些 Registry / protocol / metadata 模式?
   4. Generic Invoke 的示例文档与真实 E2E 应放在 `dubbo-admin` 还是 `dubbo-go-samples`,由谁维护?
   


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