Skip to content

[#3792][Task C] 保留 Generic Invoke 的超时、取消与业务异常分类及 HTTP 错误信息 #1632

Open

Description

@AlexStocks

目标与前置条件

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions