必须用Response::setSendCallback()在send()内部拦截重写，而非after中间件；需按Content-Type过滤仅处理JSON响应，并确保封装中间件优先级高于JsonResponse。
不能在 after 中间件里直接改 $response 的属性或调用 withJson() —— 那些操作根本不会生效，浏览器收到的仍是控制器原始输出。
为什么 $response->withContent() 在 after 中间件里有时不生效
ThinkPHP 的 Response 对象是不可变（immutable）的，withContent() 确实会返回新实例，但框架在 after 阶段已把原始响应发给 SAPI，你返回的新实例被直接丢弃。常见表现：日志里 var_dump($response->getContent()) 能看到修改后的内容，但前端收不到。
- 只有在响应真正发出前拦截（即
send()内部），修改才可控 -
after中间件拿到的是“已准备就绪”的响应，不是“待发送”的响应 - 若控制器返回的是
RedirectResponse或视图，getContent()可能为空或抛异常，需先instanceof判断类型
必须用 Response::setSendCallback() 拦截重写
这是 ThinkPHP 官方支持、唯一可靠的响应体改写入口，它在 Response::send() 执行中途触发，header 尚未发送，body 尚未输出。
- 在中间件
handle()中注册回调：\think\Response::setSendCallback(function ($response) { ... }); - 回调内可安全读取原始内容：
$content = $response->getContent(); - 只处理 JSON 响应：
$type = $response->getHeader('Content-Type')[0] ?? '';，仅当含application/json时解析+封装 - 替换后要手动重设 header：
$response->header('Content-Length', strlen($newJson));，否则可能截断或乱码 - 最后必须
return \think\Response::create($newJson, 'json');，不能只改 content
中间件顺序必须高于 JsonResponse
ThinkPHP 默认有 think\middleware\JsonResponse，它会把数组自动转 JSON 响应。如果你的封装中间件排在它后面，就会被覆盖——你封装完，它再转一次，结果变成双层 JSON。
立即学习“PHP免费学习笔记（深入）”；
- 在
app/middleware.php中用数字键显式控制优先级：5 => \app\middleware\ResponseWrapper::class - 避免用字符串键名注册，否则顺序不可控
- 验证方式：
dump(\think\Pipeline::getMiddleware());查看实际执行队列 - 若路由/控制器单独绑定了中间件，需用
->middleware(['wrapper', 'json_response'])显式声明顺序
非 JSON 响应必须放行，否则会崩
控制器可能返回视图、文件流、XML、纯文本甚至重定向。硬编码 json_decode($content) 会导致 PHP Warning 或空数组，进而封装出 {"data":[]} 这种错误结构。
- 先判断
Content-Type，只对application/json类型做处理 - 对
text/html、application/octet-stream、text/plain等类型，直接return $response; - 注意：有些接口用
response()->xml()，其 Content-Type 是text/xml，也不能进 JSON 流程 - 如果项目混用多种响应类型，建议在封装中间件开头加
if (!$response instanceof \think\Response)防御性判断
真正难的不是写回调，而是确保它只在 JSON 响应上起效、不干扰其他类型、且永远排在框架默认 JSON 处理之前——这三个条件缺一不可，漏掉任何一个都会导致线上接口返回异常结构。
