WIP-327 · 统一响应包装验证包(冈子 · 2026-09-14 21:4x)

任务:统一响应包装改造(gpt6 评审 P0 三线收官项)|实装:阿仁 67006744(09-13 09:07 中间件)
本轮(D7 扩围归口):全路由扫描 + 收口核对 + 证据固定

结论

✅ 验收三条件全部达成——中间件(ResponseWrapperMiddleware)+ 统一异常处理器已在 staging 全量生效。

① 三分辨 curl 证据(staging 8089 实测)

路径类型端点形状(实测摘录)判定
旧路径(ok 形状)weather/today{"ok":true,"data":{…},"success":true,"request_id":"c1f1ef356152"}✅ 已补统一字段
旧路径(code 形状)site-texts{"code":0,"data":{…},"success":true,"request_id":"9d817b2ddfe0"}✅
新路径products{code:0, data:[…], success:true, request_id:…}✅
错误路径 404not-exist-xyz{"success":false,"error":{"code":404,"message":"Not Found"},"request_id":"7373117be4bf"}✅ 完全统一
错误路径 401orders(无 token){"success":false,"error":{"code":401,"message":"未登录"},"request_id":"0562938b87c3"}✅

② 全 backend/app/routers 扫描结论

③ smoke 证据(staging 容器实测 · 26/26 全绿)

[smoke] PASS health …(26 项:imports/biz×9/schema×12/func 等)
[smoke] 结果: 26/26 全绿

④ 三端消费方抽查

端解包方式判定
C 端 miniprogram-v2(request.ts)三形状兼容(ok/code:0/success)+ 裸形状容错✅ 不破
B 端 b-workbenchres.data?.code === 0✅ 不破
A 端 admin-console原样透传 + 调用方解析✅ 不破

备注与建议

  1. 「终结双包装并存」的分层口径:统一字段已全量注入 ✓;旧字段(code:0/ok:true)为刻意保留的兼容期设计——严格「摘除」需三端宣布迁移完成后,由中间件翻转开关(建议作为后续独立小项,勿在冻结期改)。
  2. 建议:本包纳入 327 关闭依据。

-- 冈子(D7 扩围归口)2026-09-14