AlexStocks opened a new issue, #1631: URL: https://github.com/apache/dubbo-admin/issues/1631
## 目标与前置条件 这是 [Dubbo-Go #3742 模块 3](https://github.com/apache/dubbo-go/issues/3742) 中“大整数与嵌套参数”的受限子任务,不重新认领整个泛化调用模块。开工前与该模块现有负责人协调。 定位基线:Admin `0db71b07b9d94b2f57e3ffd22af5e55e6083e63f`。固定快照中嵌套 `{"id":9007199254740993}` 经通用 JSON 解码变成不精确的 float64。 - 生产实现以 [PR #1605](https://github.com/apache/dubbo-admin/pull/1605) 的 scalar long 精确解析、输入资源限制和字段错误契约为前置。该 PR 当前 Open;可先做复现与独立测试,但实现 PR 必须明确基于其已合入版本或明确声明的堆叠分支,不能复制一套解析器假装没有依赖。 - [PR #1527](https://github.com/apache/dubbo-admin/pull/1527) 处理 UI 数字文本保留;HTTP 输入可直接用原始 JSON 数字或字符串验证本任务。UI 未舍入不能代替后端类型正确。 ## 允许修改什么 | 路径 | 本任务允许的工作 | |---|---| | `pkg/console/service/service_generic_invoke_decode.go` | 在原始 JSON 仍无损时按现有 metadata 解析嵌套字段、数组/集合元素和可表达的 Map 值 | | `pkg/console/service/service_generic_invoke.go` | 将本次已解析的方法及其现有类型图交给 decoder;解码失败在 RPC 前返回 | | `pkg/console/service/service.go` | 仅复用或最小衔接现有 `buildTypeMap` / `buildRelatedTypes`,不重构服务发现和 method 匹配 | | 新增 `pkg/console/service/service_generic_invoke_metadata_test.go`,必要时扩展已有 Handler generic invoke 测试和 `service_generic_invoke_error.go` | 添加值/具体 Go 类型/字段路径断言;复用 #1605 字段错误类型 | 现有 metadata 使用 `Type.Properties`、`Items`、`Enums`;必须先核对真实 fixture 的含义,禁止凭数组位置发明 Map 泛型协议。只处理当前类型图能够明确表达的目标类型。 行为要求: 1. Java `long` / `java.lang.Long` 及现有 metadata 中已明确映射的等价整数目标,最终交给 SDK 的值必须是范围内的具体整数类型,不能是 float64 或未处理的 `json.Number`。 2. 复用 #1605 的精确数值解析。支持其既有十进制/科学计数法及数字字符串契约,不先转 float64,不去掉既有长度/指数限制。 3. 数字字符串只能在 metadata 明确要求整数时转换;`java.lang.String` 的 `"9007199254740993"` 必须继续是字符串。 4. 复用同一次 metadata 读取所确定的方法和类型图,不增加第二次远程类型查询或独立缓存。 5. 对缺失类型信息、无明确 Map 值类型或不支持类型:保留既有安全输入的兼容行为;一旦某个整数值/类型无法无损确定,返回明确字段错误并停止 RPC,禁止静默舍入、字符串降级或猜测为 long。 6. 保留已有 null 语义;不借此引入 required 字段、默认值、enum 验证等新 schema 语义。对递归 metadata 复用既有 visited/输入边界,不能无限递归。 ## 禁止做什么 - 不改公共请求格式:`args` 仍为 `[]json.RawMessage`;不要求客户端上传另一套类型图。 - 不改 protobuf schema、SDK、Hessian2、Triple wire、服务注册/发现、重试策略、泛化 mode 或全局 JSON 行为。 - 不重写顶层 scalar 解析,不升级根 `go.mod` / `go.sum`,不新建通用序列化框架。 - 不通过把所有整数变成字符串、把字符串变成数字,或在 SDK 前漏出 `json.Number` 来“保留精度”。 - 不伪造 metadata 的 required、Map 泛型或 Go 类型映射;无法从当前模型确定时给出阻塞证据。 - 不改 UI 的 `handleInvoke`;不重复 #1527。 ## 怎么验证对错 测试经过实际 decoder / `InvokeServiceGeneric`,只在最终 RPC 边界记录参数,不 mock decoder 或类型图逻辑。 | 场景 | 预期 | |---|---| | Bean 的 long 字段为 `9007199254740993`,分别用数字/字符串/科学计数法提供 | 进入 SDK 的整数值精确,具体 Go 类型符合目标;不能只比 JSON 文本 | | 嵌套 Bean、long 数组、metadata 可表达的集合/Map 值 | 同样精确;至少包含一项两层路径,如 `args[0].orders[2].id` | | `2^53-1`、`2^53`、`2^53+1`、int64 上下界及上下界外一位 | 合法值精确;越界值返回字段错误,RPC 边界调用次数为 0 | | 非整数输入、超长文本、巨大正负指数 | 按 #1605 的边界拒绝;不能耗时/内存失控 | | metadata 声明 String 的数字文本 | 保持字符串 | | 已支持的普通数值、null、空集合 | 保持原有语义 | | 缺失/不明确 metadata 下的不安全整数 | 明确拒绝,带实际字段路径,RPC 次数 0;不能继续猜测 | 新增测试名使用 `TestGenericInvokeMetadata` 前缀。执行 `go test ./pkg/console/service ./pkg/console/model -run 'GenericInvoke|InvokeServiceGeneric' -count=1`;涉及 Handler 字段错误时再执行 `go test ./pkg/console/handler -run 'GenericInvoke' -count=1`。先保留旧实现的失败输出,再给出修复后的通过输出。任何全包基线失败单列,不降断言。 ## 交付与依赖 - 一份最小生产修复 PR、失败/通过记录,以及“支持的 metadata 形态 / 明确拒绝的形态”表。 - 单元/Service 验证只证明 RPC 前参数边界。真实 Provider 的值和类型验收由 Task D 承接,不能在本 PR 中伪称已完成跨语言 E2E。 - 推荐后端 1 人负责本任务,再串行处理 Task C,避免同时修改 `service_generic_invoke.go` 和错误接口;串行安排不代表两者有功能依赖。 ## 接手与提交约束 - 本任务从审计总单 [Dubbo-Go #3792](https://github.com/apache/dubbo-go/issues/3792) 拆出。首次修改前,记录目标仓库实际 Base/Head SHA,重读总单及本任务关联 PR 的当前状态;以下固定源码用于定位,不能假定接手时的 develop 未变化。 - 生产代码与测试 harness 的权限以本 Issue 为准。发现超出允许范围的问题,提交最小复现和关联阻塞项;不得通过改依赖、改协议、改测试期望或隐式降级扩大范围。 - 使用独立分支/工作区,保留其他人的修改。PR 仅关闭本子任务,不能使用 `Fixes apache/dubbo-go#3792` 或关闭 [功能总单 #3742](https://github.com/apache/dubbo-go/issues/3742)。 - 交付记录必须包含:实际改动路径、Base/Head SHA、完整命令、退出码、断言结果、跳过项和阻塞项。测试 PASS、产品 FAIL、环境 BLOCKED、未执行 NOT_RUN 分开记录;不能用“命令退出 0”替代实际断言。 -- 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]
