thinkphp 6.1.5 接口异常处理需先通过 $request->expectsjson() 准确识别 api 请求，再在 render 方法中统一返回标准 json 格式（含 code/msg/data），生产环境隐藏敏感错误信息，并确保 default_return_type 配置为 'json' 避免 html 包裹。
ThinkPHP 6.1.5 的接口异常捕获与错误返回处理，核心在于区分请求类型（JSON 还是 HTML）、统一响应结构、并确保异常不暴露敏感信息。重点不是“能不能捕获”，而是“捕获后怎么安全、规范地返回”。
识别请求是否为 API 调用
框架不会自动判断你当前是不是在写接口，得自己明确区分。关键看两点：
- 请求头是否带 X-Requested-With: XMLHttpRequest
- Accept 头是否包含 application/json，或直接调用
$request->expectsJson()
别只依赖 URL 后缀或路由分组——这些容易被绕过，也不符合 REST 原则。TP6.1.5 中 $request->expectsJson() 是最可靠的方式，它内部已综合判断了 header 和常见 AJAX 特征。
自定义 render 方法统一 JSON 错误格式
在 app/ExceptionHandle.php 的 render 方法中，针对 API 请求，应返回标准 JSON 结构，例如：
- 状态码用异常本身的 HTTP 状态（如
HttpException的getStatusCode()），非 HTTP 异常统一用 500 - 消息字段用
$e->getMessage()，但生产环境建议替换为泛化提示（如“系统繁忙”），避免泄露路径、SQL 或类名 - 数据字段保持空数组
[]，不塞堆栈或调试信息
示例代码片段：
if ($isJson) {return json([
'code' => $e instanceof HttpException ? $e->getStatusCode() : 500,
'msg' => app()->isDebug() ? $e->getMessage() : '服务异常',
'data' => []
])->code($e instanceof HttpException ? $e->getStatusCode() : 500);
}
验证失败也要走统一出口，不能只靠 try-catch
ValidateException 是常见异常，但仅靠 try...catch 容易漏掉控制器里未显式捕获的场景。更稳妥的做法是：
- 在全局中间件中监听
ValidateException，记录原始参数并返回统一 JSON 错误（含具体字段错误） - 验证器类中用
$this->failException(true)触发异常，而不是返回 false - 错误消息不要硬编码在 validate 数组里，改用语言包（
lang/zh-cn/validate.php）便于多语言和统一管理
这样所有校验失败都经过同一出口，前端能稳定解析 msg 字段，后端也方便做参数审计。
避免响应类型混淆导致 JSON 被套成 HTML
TP6.1.5 默认响应类型受 default_return_type 配置影响。如果接口返回的是 json($data) 却看到一整页 HTML 包裹的 JSON 字符串，大概率是这个配置被设成了 'html'。
- 检查
config/app.php中'default_return_type' => 'json' - 接口方法里统一用
return json($data)，不要混用echo json_encode() - 必要时加 header 强制：
json($data)->header('Content-Type', 'application/json')
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
