hook 业务报错在控制台 toast 显示英文调试噪音([ObjectStack] hook 'x' threw: Error: …)

[baozhoutao]

现象

在控制台删除被引用记录时,引用完整性 hook 抛出的业务错误在报错 toast 里显示成:

[ObjectStack] hook 'pm_ref_base' threw: Error: 制作基地被「项目主计划批次」引用(3 条),删除被阻断,请先解除引用

最终用户不关心错误来自哪个 ObjectStack hook——throw new Error('…') 是 hook 作者刻意表达的业务规则,toast 应该只显示:

制作基地被「项目主计划批次」引用(3 条),删除被阻断,请先解除引用

根因(三层拼接)

1. QuickJS 沙箱把 hook 抛错包装成 hook 'x' threw: Error: …(SandboxError.message,本意是服务端日志用),原始业务消息保留在 .innerMessage;
2. REST 数据路由的 mapDataError 没有解包 innerMessage(自定义 action 路由 http-dispatcher 里早就解包了,数据 CRUD 路径漏了);
3. 客户端 SDK _fetch 又拼了 [ObjectStack] CODE: 前缀。

修复要求

• toast 只显示业务消息本身;
• 完整调试包装(hook 名 + 堆栈)仍要写服务端日志,排障不受影响;
• TypeError: 等非默认错误名保留(真实脚本 bug 的信号,区别于业务规则);
• 兼容旧版打包 client(不能返回会被旧 client 拼进消息的 code 字段)。

待办

• 服务端 REST mapDataError 解包 innerMessage + 正则兜底
• 客户端 SDK 去掉 [ObjectStack] CODE: 前缀
• dogfood 全链路金测试(真实内核 + 沙箱 hook + 真实 REST)
• 合并发版后真机 UI 实测,截图回帖本 issue

[baozhoutao]

测试报告(代码级,PR #2893)

1. dogfood 全链路金测试(新增 packages/dogfood/test/hook-error-format.dogfood.test.ts)

非 mock 拼图——通过 @objectstack/verify 的 bootStack 启动真实内核(QuickJS 沙箱 + ObjectQL + SQLite 驱动 + 真实 REST 路由 + auth),fixture 里注册沙箱 hook 抛出与线上一模一样的业务错误:

#	断言	结果
1	DELETE 被沙箱 hook 阻断 → HTTP 400,body.error 只含业务消息(无 threw:、无 hook '、无 [ObjectStack]、无 code 字段)	✅
2	ground truth:被阻断的记录仍然存在(GET 200)	✅
3	throw new TypeError('boom') → body.error 为 TypeError: boom(非默认错误名保留,标记真实脚本 bug)	✅

3/3 通过。同时测试输出确认服务端日志仍打印完整调试包装 + 堆栈([BodyRunner] sandboxed hook threw {"hook":"hef_ref_guard","error":{"message":"hook 'hef_ref_guard' threw: Error: 制作基地被…"}})——排障能力不受影响。

2. 单元测试

• @objectstack/rest:+4(innerMessage 解包 / 实例丢失时正则兜底 / TypeError 保名 / action 包装同样解包),255 passed
• @objectstack/client:+2(error.message 原样、[ObjectStack]/CODE 前缀移除但 error.code 仍可编程读取 / 空 body 回退 statusText),111 passed

3. CI

PR #2893 全部 checks 绿(含 Dogfood Regression Gate、Test Core、TypeScript Type Check)。

待办

• 合并发版、objectui 重建打包的 @objectstack/client 并 re-vendor console 后,真机 UI 实测删除被引用记录,截图回帖本 issue。注:服务端 REST 侧修复对旧版打包 client 立即生效(新分支不返回 code,旧 client 无噪音可拼),客户端前缀移除需等 console 刷新。