Repository navigation
Description
目标与前置条件
这是 Dubbo-Go #3742 模块 4 中“错误语义”的受限子任务,与该模块现有负责人协调,不接管 typed result 或整个 UI。
定位基线:Admin 0db71b07b9d94b2f57e3ffd22af5e55e6083e63f 的 InvokeServiceGeneric 在 RPC 返回错误时统一构造 InternalError,丢失超时和业务异常类别。
依赖 PR #1605 的 validation error 类型及 writeGenericInvokeError 路径。当前该 PR Open;实现必须明确基于其合入版本或声明堆叠关系,不另建一套 Handler。
允许修改什么
pkg/console/service/service_generic_invoke.go及同目录 generic invoke 专用 error 文件:在错误被统一包装前保留原始 cause,用标准错误链识别已知类别。pkg/console/handler/service.go、generic invoke 专用 error writer、必要的pkg/console/model/service.go:只给这个接口添加结构化错误信息。- 对应 Service / Handler 的
service_generic_invoke_error_test.go;已有文件时追加行为用例而非替换。新增用例前缀为TestGenericInvokeRPCError和TestServiceGenericInvokeHTTPRPCError,不改成功响应、不扩展全局错误框架。
本子任务的新增 HTTP 契约为:保留现有 code/message/data envelope、HTTP status 行为和 #1605 的 field/expected/actual;对 RPC 错误 在 data 中添加 errorType。已知业务异常还提供 exceptionClass、exceptionMessage。这是待实现的接口扩展,不是声称当前上游已有。
| 可验证的原始 cause | data.errorType |
|---|---|
errors.Is(err, context.Canceled) |
canceled |
errors.Is(err, context.DeadlineExceeded) |
timeout |
当前 SDK 返回、可通过 errors.As 识别的 hessian2.GenericException |
business |
| 可通过标准/SDK 已有类型识别的网络错误 | transport |
| SDK 已有稳定公开类型能明确识别的序列化错误 | serialization |
| 缺乏稳定类型证据的其他 RPC 错误 | unknown |
- 业务异常字段只输出确定的 class 和业务 message;不返回堆栈、整个 cause 链、网络地址或底层诊断串。
- 无法可靠区分的错误必须为
unknown,不能匹配err.Error()中的关键词猜类别。 - 校验错误仍走 feat: validate generic invoke wire contract and API arguments #1605 字段错误契约,不得误标为 RPC
unknown。 - Go 侧的 cause 必须能够被
errors.Is/As找到;不能通过拼接字符串“保留”原始错误。
禁止做什么
- 不改 Dubbo-Go SDK、Hessian2、Triple、RPC 重试/超时默认值和根依赖版本。
- 不为补分类而新增 SDK 公共异常 alias;Admin 可直接复用当前已可导入的真实类型。
- 不把收到
context.Canceled的单测当成“HTTP 客户端断开已取消 Provider”。取消传播仍是待真实验证的跨层契约,本任务不改AppContext或 HTTP context 模型。 - 不修改其他 API 的 CommonResp / HTTP status 语义,不删除 feat: validate generic invoke wire contract and API arguments #1605 的字段错误,不改成功结果和 typed result。
- 不改前端调试页,不顺手实现 mode 选择;UI 的专门展示继续由 #3742 模块 4 跟踪。
- 不在生产代码加入测试专用全局开关或绕过真实 RPC 的分支。
harness 边界与验证
允许在 Service 测试中替换最终 RPC 边界来注入错误;真实 Service、cause 包装和 Handler writer 必须运行。所有边界替换恢复原值,不能与并行测试共享可变全局状态。
| 验证 | 必须断言 |
|---|---|
直接及 %w 包装的 Canceled / DeadlineExceeded |
HTTP data.errorType 各自正确;Go cause 可识别 |
| 真实 GenericException 类型及其包装值 | business,class/message 保留指定 fixture 内容,未暴露堆栈 |
| typed 网络错误 | transport |
| 无可判定类型的错误 | unknown;响应不泄露底层诊断字符串 |
| 字段校验错误、未知 signature | #1605 的字段错误保持,RPC 调用次数为 0 |
| 已有成功调用 | 成功 envelope、elapsedMs、rawResult 不改变 |
执行 go test ./pkg/console/service ./pkg/console/handler ./pkg/console/model -run 'GenericInvoke|InvokeServiceGeneric' -count=1。先证明旧实现不能保留类别,再验证修复。序列化类型若 SDK 没有可靠公开入口,提交查到的源码证据并覆盖 unknown,不能为了填满表格编造类型。
交付与人员
- 一份后端 PR,附逐类 HTTP 响应、cause 链测试和原始输出。
- API 契约验收与真实网络验收分开;Java 业务异常跨 RPC 及客户端取消传播仍由既有 #3742 / Task D 记录。
- 与 Task B 推荐由同一后端开发者串行完成。其他任务的作者不得同时改动本任务的生产错误路径。
接手与提交约束
- 本任务从审计总单 Dubbo-Go #3792 拆出。首次修改前,记录目标仓库实际 Base/Head SHA,重读总单及本任务关联 PR 的当前状态;以下固定源码用于定位,不能假定接手时的 develop 未变化。
- 生产代码与测试 harness 的权限以本 Issue 为准。发现超出允许范围的问题,提交最小复现和关联阻塞项;不得通过改依赖、改协议、改测试期望或隐式降级扩大范围。
- 使用独立分支/工作区,保留其他人的修改。PR 仅关闭本子任务,不能使用
Fixes apache/dubbo-go#3792或关闭 功能总单 #3742。 - 交付记录必须包含:实际改动路径、Base/Head SHA、完整命令、退出码、断言结果、跳过项和阻塞项。测试 PASS、产品 FAIL、环境 BLOCKED、未执行 NOT_RUN 分开记录;不能用“命令退出 0”替代实际断言。
Activity