|
|
aea1a2c48d
|
fix(provider): 上游错误文案别再丢 —— 补网关/腾讯错误体形状 + 修误导性日志
## 发现路径：读生产日志（不是测试报红）
```
unhandled upstream error body (adapter "openai" lacks transform_error):
status=404 body={"error_msg":"404 Route Not Found"}
unhandled upstream error body (adapter "buddy" lacks transform_error):
status=400 body={"code":11101,"msg":"Non-stream chat request is currently not supported",...}
```
### ★ 缺陷 A：错误体形状漏了「网关」与「腾讯系」两类
`__prelude.openai_error()` 只认 `error.message` / `error`(裸串) / `{code,message}`
/ `detail` / HTML `<title>` / 裸文本 六种，**没有** `error_msg`（华为/APISIX 网关）
与 `msg`（腾讯系用 msg 而非 message）⇒ 返回 nil
⇒ 客户端只看到 `api error 404: unknown error`，**而 body 里明明有可用文案**。
修法照参考（llm-adapter.ts:524 `errorDetail()` 显式认 `error_code`/`error_msg`；
buddy-adapter.ts:576 认 `msg` + `displayMsg.{zh,en}`）：
- 新增 `{error_msg}` / `{msg}` / `{error_code,+error_msg}` 三种形状；
- 新增 `displayMsg.{zh,en}` 本地化文案，**排在最前**（参考注释明说"本地化文案
最可读"；其早期实现只读 `error.*`/`message` ⇒ 全部落空 ⇒ 把 291 字符原始
报文糊进错误提示，而服务端早已备好中文说明）。
覆盖 7 个用共享前导的适配器：buddy/deepseek/github/groq/kimicode/openai/sensenova。
### ★ 缺陷 B：内核那句日志会把人带偏
措辞是 `adapter %q lacks transform_error`，但 **openai.lua:139 与 buddy.lua:166
都明明定义了该钩子** —— 真实原因只是它**返回了 nil**（认不出那个形状）。
我照着这句话去适配器里找"有没有这个函数"，查了几轮才发现函数在、是返回值空。
修法：内核直接查事实（`p.vm.HasFn(adapter, "transform_error")`），
两种原因**分开措辞**，不再猜。
## 判据
`internal/lua/adapter_prelude_error_shapes_test.go`：
- 12 个形状子用例（4 个新增 + 6 个回归 + 2 个 displayMsg），
**装载仓库里真实的 openai.lua**（含共享前导），不是自造桩 ——
第一版用空 VM 跑，12 个全 FAIL（`adapter openai not loaded`），
那等于什么也没验。
- 配对判据 `...StillReportsUnknownShapes`：真正认不出的形状仍须 `ok=false`，
防止"为了让上面通过就把『抽不出』和『没这个钩子』混为一谈"。
- 变异：删掉新增的 error_msg/msg 分支 ⇒ APISIX 用例报红。
## 备注
`anthropic/gemini/mistral/ollama/opencodezen/qwen38/trae` 有自己写的
`transform_error`，不走共享前导，**未获得**本次新增形状（各自协议的错误体
本就不同）。此处只修共享前导的 7 个。
|
2026-10-17 00:37:52 +08:00 |
|
