laravel异常处理由 appExceptionsHandler 类统一管理，核心是 report() 方法记录异常、render()方法返回响应；需按请求类型（网页 /API）和异常语义定制逻辑，避免生产环境开启调试模式。
在 Laravel 中，异常和错误统一由 AppExceptionsHandler 类处理，它负责记录、渲染和响应各类异常。核心逻辑集中在 render() 和 report() 两个方法上，自定义时无需重写整个流程，只需按需覆盖即可。
report() 方法：记录异常到日志或第三方服务
该方法用于“上报”异常，比如写入日志、发送告警、同步到 sentry 等。Laravel 默认已调用 Log::Error() 记录所有未捕获异常。
常见扩展方式：
- 对特定业务异常（如
OrderException）额外触发企业 微信 / 钉钉 通知 - 忽略某些预期异常（如
ValidationException），避免刷屏日志 - 补充上下文信息（用户 ID、请求 URL、IP）便于排查
示例：
public function report(Throwable $throwable): void {if ($throwable instanceof CustomBusinessException) {Log::warning('业务异常', [ 'message' => $throwable->getMessage(), 'user_id' => auth()->id(), 'url' => request()->fullUrl(), ]); // 可选：发通知 notifyAdmin("⚠️ 业务异常：{$throwable->getMessage()}"); } parent::report($throwable); }
render() 方法：决定如何向用户返回响应
该方法决定异常“怎么展示”，返回一个 Response 实例。Laravel 默认对 http 异常（如 404、500）返回视图，对 API 请求返回 jsON。
关键点：
- 通过
$request->expectsjson()判断是网页还是 API 请求 - 可针对不同异常类型返回定制化响应（如模型未找到时返回 404 JSON）
- 不建议在 render 中抛出新异常，否则可能陷入 递归
示例：
public function render($request, Throwable $throwable): Response|ResponseFactory {if ($throwable instanceof ModelNotFoundException && $request->expectsJson()) {return response()->json(['message' => '资源不存在', 'error' => 'not_found',], 404); } if ($throwable instanceof ValidationException && $request->expectsJson()) {return response()->json(['message' => '验证失败', 'errors' => $throwable->errors(), ], 422); } return parent::render($request, $throwable); }
自定义异常类 + 注册到 $dontReport
对于明确属于“预期内”的异常（如 表单验证 失败、权限不足），可 继承 Exception 创建语义化类，并选择性屏蔽日志记录，避免干扰真实问题。
操作步骤：
- 新建
app/Exceptions/PermissionDeniedException.php - 在
app/Exceptions/Handler.php的$dontReport数组中加入该类 - 在
render()中单独处理其响应格式
这样既保持 代码可读性，又让日志更聚焦于真正需要关注的错误。
调试模式与生产环境的 区别
APP_DEBUG=true 时，Laravel 显示带 堆栈 的详细错误页（Whoops）；APP_DEBUG=false 时，统一返回通用 500 页面（或你配置的 resources/views/errors/500.blade.php）。
注意：
- 不要在生产环境开启 debug，会暴露路径、配置、数据库 结构等敏感信息
- API 接口 即使 debug 关闭，也会默认返回简洁 JSON 错误（除非你重写了 render）
- 自定义错误页面放在
resources/views/errors/xxx.blade.php，支持 404、403、500 等 状态码 命名
基本上就这些。Handler 不复杂但容易忽略细节，关键是分清 report（记下来）和 render（给出去）的职责，再结合请求类型和异常语义做轻量定制。
以上就是 Laravel 如何处理异常和错误？（Handler 示例）的详细内容，更多请关注 php 中文网其它相关文章！
