LaravelAPI错误处理怎么优化_LaravelAPI错误处理的优化技巧【技巧】-Laravel-PHP中文网

app\exceptions\handler::render() 不能直接返回 json，因 laravel 默认依请求头判格式，api 请求易被误判为 html；应优先用 $request->expectsjson() 判定并统一 json 响应结构，区分异常类型设状态码与字段，report() 仅上报，render() 仅响应，错误响应须遵循 { "success": false, "message": "...", "code": "...", "details": [...] } 契约。

laravelapi错误处理怎么优化_laravelapi错误处理的优化技巧【技巧】

为什么 `App\Exceptions\Handler::render()` 不能直接返回 JSON？

因为 Laravel 的 render() 方法默认会根据请求头判断响应格式，但 API 请求常被误判为 HTML（比如 Postman 默认不带 Accept: application/json），导致返回 HTML 错误页而非 JSON。这会让前端拿不到结构化错误信息，调试时只能看到 500 页面。

强制统一 API 响应格式：在 app/Exceptions/Handler.php 的 render() 中先判断是否为 API 请求（检查路由前缀或中间件组）
用 $request->expectsJson() 比手动解析 Accept 头更可靠，它已内置对 application/json、*/* 和 AJAX 请求的兼容
别在 render() 里 throw 新异常——会导致递归调用 render()，最终报 Maximum function nesting level reached

怎么让不同异常返回不同 HTTP 状态码和字段？

默认的 ValidationException 返回 422，但自定义异常（比如 BusinessLogicException）可能需要 400、403 或 409，且要附带 code、message、details 字段。硬编码 if-else 判断类型容易漏、难维护。

在 render() 里用 instanceof 区分异常类型，比 switch get_class() 更安全（避免类名拼写错误）
对 ModelNotFoundException，返回 404 并补全资源名：['code' => 'resource_not_found', 'message' => "User not found"]
对 AuthorizationException，统一转为 403，并隐藏敏感逻辑（不要暴露“你没权限删这个”，只说“操作被拒绝”）
所有 JSON 响应必须调用 response()->json(..., $status)，别忘了传第二个参数，否则默认是 200

`report()` 和 `render()` 到底该放什么逻辑？

很多人把日志记录、 Sentry 上报、邮件告警全塞进 render()，结果接口变慢、重复上报、甚至阻塞响应。这是典型职责混淆。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

report() 只做一件事：记录和上报。它不返回响应，也不影响用户看到的内容。所有异常都该进这里，包括 404（Laravel 默认不 report 404）
render() 只做一件事：决定「用户看到什么」。它不该触发外部请求（如调用 Slack webhook），也不该写文件日志（log 已由 report() 处理）
注意：ValidationException 默认不会进 report()，需在 app/Exceptions/Handler.php 显式重写 shouldReport() 方法返回 true

API 错误响应结构不一致，前端怎么接？

有的接口返回 { "message": "..." }，有的是 { "error": { "code": "...", "message": "..." } }，前端得写一堆 if 分支，一加新字段就崩。

定义一个最小契约：所有 API 错误响应必须是 { "success": false, "message": string, "code": string?, "details": array? }
用中间件或基类控制器统一包装错误响应，而不是每个 render() 各写一遍 json()
验证失败时，Validator 的 errors() 是 MessageBag，别直接丢给前端；用 $validator->errors()->getMessages() 转成数组再塞进 details
别在错误响应里暴露 file、line、trace —— 这些只该出现在本地日志或 debug=true 时的开发环境响应中