ThinkPHP 404默认返回HTML，需分三类统一转JSON：1. 路由未匹配用route_not_found事件+Response::create()->code(404)；2. 方法不存在用method_not_found事件同理处理；3. 主动抛出的HttpException(404)须在render方法中优先拦截并return json()。
ThinkPHP 404错误默认返回HTML，怎么改成JSON？
ThinkPHP 默认在找不到路由或控制器方法时，会渲染 404.html 模板并返回 HTML 响应体和 404 状态码。如果你的项目是纯 API 场景（比如前后端分离、小程序后端），这种 HTML 返回会让前端解析失败，必须强制统一为 JSON 格式。
全局捕获未匹配路由，用App::event拦截404
ThinkPHP 5.1+ 支持在应用初始化阶段监听 route_not_found 事件，这是最干净、不侵入业务逻辑的方式。注意：该事件仅在路由完全未匹配时触发（不是控制器方法不存在）。
在 app/common.php 或 app/Event.php 中注册：
use think\App;
use think\Response;
App::event('route_not_found', function ($request) {
return Response::create(['code' => 404, 'msg' => 'Not Found'], 'json')->code(404);
});
- 必须用
Response::create()构造响应对象，直接return json([...])会触发二次输出，报错 - 显式调用
->code(404)是必要的，否则状态码仍是 200 - 此方式不影响正常 404 页面在 Web 浏览器中的显示（因为 JSON 响应头
Content-Type: application/json，浏览器不会渲染）
控制器方法不存在时的404（method_not_found）也要处理
上面的 route_not_found 不覆盖“路由匹配成功但方法不存在”的情况（例如访问 /api/user/delet，而实际只有 delete）。这类错误由 method_not_found 事件触发。
立即学习“PHP免费学习笔记（深入）”；
同样在事件注册处补充：
App::event('method_not_found', function ($request, $controller, $action) {
return Response::create(['code' => 404, 'msg' => 'Method not found'], 'json')->code(404);
});
- 两个事件需同时注册，缺一不可
-
$controller和$action是可用参数，可用于日志记录，但不要在响应中暴露具体类名或方法名（安全考虑） - 若使用了中间件做权限或路由预检，确保事件注册代码在中间件执行前完成（推荐放
common.php）
调试时容易忽略的点：异常抛出路径 vs 路由404
真正导致 JSON 化失败的，往往不是路由问题，而是控制器里手动抛出的 HttpException（比如 throw new HttpException(404, 'xxx')）。这类异常走的是异常处理流程，不触发上面两个事件。
- 检查
app/exception.php中的render方法是否对HttpException做了特殊处理 - 如果希望所有 404（包括主动抛出）都返回 JSON，在
render中加判断：
if ($e instanceof HttpException && $e->getStatusCode() === 404) {
return json(['code' => 404, 'msg' => $e->getMessage()]);
}
这个分支要放在其他异常类型判断之前，否则会被更宽泛的 Exception 捕获吞掉。
真正的难点不在写几行代码，而在理清 ThinkPHP 内部这三类 404 的触发路径：路由未匹配、方法未定义、异常抛出——它们各自走不同的钩子，漏掉任何一个，前端就可能收到意外的 HTML 或空白响应。
