直接修改 resources/views/errors/404.blade.php 和 500.blade.php 即可自定义对应错误页，Laravel 自动识别；需确保命名准确、后缀完整，且 APP_DEBUG=false 才可见自定义 500 页。
怎么替换 Laravel 默认的 404/500 错误页面
直接改 resources/views/errors/404.blade.php 和 resources/views/errors/500.blade.php 就行，Laravel 会自动加载这些视图。不需要动任何配置或重写异常处理器——只要文件存在，就会优先用它。
常见错误是把文件放在 views/ 下但没按命名规范：必须叫 404.blade.php、500.blade.php（不能是 not-found.blade.php），也不能漏掉 .blade.php 后缀。
- 开发环境触发 500 页面时，Laravel 默认仍显示调试页面（
Whoops），要看到自定义 500 视图，得先设APP_DEBUG=false - 404 页面在路由未匹配时触发，但中间件抛出的
NotFoundHttpException也算，所以自定义后所有 404 都走这个视图 - 视图里可以用
$exception变量访问异常对象（仅限 500 页面），但 404 页面里这个变量不存在
如何让特定异常跳转到自定义页面（比如 TokenMismatchException）
靠重写 App\Exceptions\Handler::render() 方法，对目标异常返回响应即可。这是最常用也最可控的方式，比全局替换视图更精准。
比如想把表单 CSRF 失败统一导向友好提示页，而不是默认的 401 或白屏：
public function render($request, Throwable $exception)
{
if ($exception instanceof TokenMismatchException) {
return response()->view('errors.csrf', [], 419);
}
return parent::render($request, $exception);
}
- 注意 HTTP 状态码别乱设：
TokenMismatchException对应的是 419，不是 403 或 500；浏览器和前端逻辑可能依赖这个码 -
response()->view()第二个参数是视图数据，可传['message' => '请刷新页面重试']这类提示 - 别在
render()里 throw 新异常，会导致无限递归崩溃
为什么自定义了 Handler::render 却没生效
大概率是缓存没清，或者异常类型判断错了。Laravel 的异常处理链很短，但有几个关键断点容易被忽略。
- 执行
php artisan config:clear和php artisan view:clear，否则修改后的Handler类可能被 OPCache 或视图缓存绕过 - 检查异常是否被中间件提前捕获——比如某些 JWT 或权限中间件自己
abort(401)，根本不会进Handler::render - 用
get_class($exception)打印下实际类型，ValidationException和ModelNotFoundException都是常见“看着像 404 实际不是”的情况 - 如果用了
dd()或Log::error()在render()里调试，记得别在生产环境留着，会暴露路径或敏感信息
能不能在错误页面里用 Vue/React 组件
可以，但得手动引入，Laravel 错误视图默认不走 Webpack 编译流程。你得确保 JS/CSS 资源是静态可访问的，且不依赖 Laravel 的 @vite 或 @stack 指令。
- 把构建好的
app.js放到public/js/error-app.js，然后在errors/500.blade.php里用<script src="/js/error-app.js"></script> - 别在错误页面里调用
@vite，它依赖vite manifest.json，而该文件在异常发生时可能不可读或根本没生成 - 如果组件需要服务端数据（比如错误 ID 用于上报），只能通过内联 JS 注入：
<script>window.errorId = "{{ $errorId ?? '' }}";</script>
真正麻烦的不是加组件，而是确保这些资源在 PHP 崩溃、OPCache 失效、甚至磁盘满的时候依然能加载——错误页本身不该再成为故障点。
