Laravel捕获NotFoundHttpException失败，如何返回自定义响应？

我来帮你梳理下问题所在和解决办法，你遇到的情况其实在Laravel里挺常见的，咱们一步步来排查：

常见原因1：Fallback路由拦截了异常 #

如果你的路由文件（routes/web.php或routes/api.php）里定义了Route::fallback()，那Laravel在找不到匹配路由时，会直接执行这个回调返回响应，不会抛出NotFoundHttpException，所以你的异常处理器根本接收不到这个异常。

修复方式： #

• 如果你想通过异常处理器来处理404，直接删除Route::fallback()的定义；
• 或者在fallback路由里手动抛出异常，让处理器捕获：

  Route::fallback(function () {
      throw new \Symfony\Component\HttpKernel\Exception\NotFoundHttpException();
  });
  

常见原因2：异常类型判断不匹配 #

有时候你以为抛出的是NotFoundHttpException，但实际可能是Laravel自身的路由异常类（Illuminate\Routing\Exceptions\NotFoundHttpException，它继承自Symfony的同名类）。不过按继承关系来说，你的instanceof判断应该能命中，但保险起见可以先确认异常的实际类型：

临时调试方法： #

在你的render方法里添加一行代码，打印异常的完整类名：

public function render($request, Exception $exception) {
    // 临时打印异常类，之后可以删掉
    dd(get_class($exception));
    
    switch (true) {
        // ... 你的原有代码
    }
}

运行触发404的请求，就能看到实际抛出的异常类，之后再调整你的instanceof判断即可。

更优雅的处理方式：使用Laravel的renderable方法 #

Laravel推荐在Handler的register方法里单独注册异常处理逻辑，比在render里写switch更清晰，也不容易出错：

重构后的代码： #

namespace App\Exceptions;

use Exception;
use Illuminate\Database\QueryException;
use Illuminate\Auth\AuthenticationException;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;

class Handler extends ExceptionHandler {
    public function register()
    {
        // 处理NotFoundHttpException
        $this->renderable(function (NotFoundHttpException $e, $request) {
            // 如果是API请求返回JSON，否则返回404视图
            return $request->expectsJson() 
                ? response()->json('NotFoundHttpException', 404)
                : response()->view('errors.404', [], 404);
        });

        // 处理QueryException
        $this->renderable(function (QueryException $e, $request) {
            return response()->json('QueryException');
        });

        // 处理AuthenticationException
        $this->renderable(function (AuthenticationException $e, $request) {
            return response()->json('AuthenticationException');
        });

        // 其他异常的默认处理
        $this->renderable(function (Exception $e, $request) {
            return response()->json('Different Exception');
        });
    }
}

这种方式会自动按异常类型匹配处理逻辑，比switch更直观，也符合Laravel的最佳实践。

额外提示：区分API和Web请求 #

如果你的应用同时有API和Web界面，建议用$request->expectsJson()来判断，返回对应的JSON响应或404视图，提升不同场景下的用户体验。

内容的提问来源于stack exchange，提问作者Robert Kujawa