在 Laravel 中注册自定义异常处理需修改 app/Exceptions/Handler.php 的 render() 方法，按异常类型精准判断并返回响应，避免宽泛捕获，确保未匹配异常交由 parent::render() 处理。
如何在 Laravel 中注册自定义 Exception Handler？
Laravel 默认用 App\Exceptions\Handler 类处理所有异常，但这个类本身不能直接“继承并替换”，你得把它当成入口，在里面做分发或重写逻辑。真正要自定义的是「怎么处理某类异常」，而不是换掉整个 Handler 类——Laravel 不允许你随意绑定另一个 Handler 实现。
- 修改
app/Exceptions/Handler.php，在 render() 方法里判断异常类型，提前返回响应
- 不要试图在服务提供者里重新
bind Illuminate\Contracts\Debug\ExceptionHandler，这会破坏框架内部错误上报和调试行为
-
report() 方法适合记录日志或转发到 Sentry，render() 才负责返回 HTTP 响应
public function render($request, Throwable $exception)
{
if ($exception instanceof CustomValidationException) {
return response()->json([
'message' => '验证失败',
'errors' => $exception->errors()
], 422);
}
<pre class='brush:php;toolbar:false;'>return parent::render($request, $exception);
app/Exceptions/Handler.php，在 render() 方法里判断异常类型，提前返回响应 bind Illuminate\Contracts\Debug\ExceptionHandler，这会破坏框架内部错误上报和调试行为 report() 方法适合记录日志或转发到 Sentry，render() 才负责返回 HTTP 响应 }
什么时候该新建一个 Exception 类？
不是所有异常都需要单独建类。只有当你需要「区分处理逻辑」「携带额外上下文」或「避免 if 判断堆叠」时才值得抽离。
- 比如表单验证失败、业务规则拒绝（如余额不足）、第三方 API 调用超时，这三类错误前端要展示不同提示，且后端要走不同日志通道
- 直接 throw new
Exception('xxx') 无法被精准识别，建议继承 Exception 或更具体的基类（如 RuntimeException）
- 类名必须以
Exception 结尾，否则 IDE 和 PHPStan 可能无法识别其语义
Exception('xxx') 无法被精准识别，建议继承 Exception 或更具体的基类（如 RuntimeException） Exception 结尾，否则 IDE 和 PHPStan 可能无法识别其语义 示例：app/Exceptions/InsufficientBalanceException.php
namespace App\Exceptions;
<p>class InsufficientBalanceException extends RuntimeException
{
}render() 里怎么避免覆盖系统级异常？
很多人加完自定义逻辑后，发现 404、500 页面不显示了，或者 Telescope 日志断了——问题出在过早 return，绕过了 parent::render()。
- 一定要把自定义分支写在
parent::render() 之前，且只对明确识别的异常类型处理
- 不要用
instanceof Exception 这种宽泛判断，它会吞掉 NotFoundHttpException、TokenMismatchException 等框架内置异常
- 如果你用了
response()->view() 返回 Blade 页面，确保对应视图存在，否则会触发二次异常，陷入无限循环
parent::render() 之前，且只对明确识别的异常类型处理 instanceof Exception 这种宽泛判断，它会吞掉 NotFoundHttpException、TokenMismatchException 等框架内置异常 response()->view() 返回 Blade 页面，确保对应视图存在，否则会触发二次异常，陷入无限循环 常见错误写法：
// ❌ 错误：捕获太宽，连 404 都被截了
if ($exception instanceof Exception) { ... }
<p>// ✅ 正确：只拦截你定义的类，其余全交给父类
if ($exception instanceof InsufficientBalanceException) { ... }API 和 Web 请求共存时怎么统一异常格式？
Laravel 默认对 AJAX 请求返回 JSON，普通请求返回页面，但如果你的项目前后端分离，所有接口都应返回 JSON，哪怕是在本地开发时访问 /login 也期望看到 JSON。
- 别依赖
$request->expectsJson() 做判断，它只看 header，容易被绕过或误判
- 更可靠的方式是按路由前缀区分：比如所有
api/* 路由强制 JSON，其余走页面
- 在
render() 里加一层路由匹配比判断请求类型更稳定
if ($request->routeIs('api.*') && $exception instanceof CustomException) {
return response()->json([...], 400);
}
$request->expectsJson() 做判断，它只看 header，容易被绕过或误判 api/* 路由强制 JSON，其余走页面 render() 里加一层路由匹配比判断请求类型更稳定 Laravel 的异常处理机制本身很轻量，但一旦开始定制，就很容易在 render() 里堆积条件判断，最后变成难以维护的状态。最稳妥的做法是：每个自定义异常类只解决一个明确场景，且在 render() 中保持单层 if 分支，不嵌套、不 fallback。
