直接修改 resources/views/errors/404.blade.php 和 500.blade.php 即可自定义错误页,Laravel 自动加载;但 APP_DEBUG=true 时 500 页被 Whoops 替代,需设为 false 才生效,404 页在调试模式下仍生效。
如何在 Laravel 中替换默认的 404 和 500 错误页面
直接改 resources/views/errors/404.blade.php 和 resources/views/errors/500.blade.php 就行。Laravel 会自动优先加载这两个文件,无需额外配置或注册。
注意:这两个文件必须放在 resources/views/errors/ 目录下,且文件名严格为 404.blade.php、500.blade.php(大小写敏感),否则不生效。
- 首次使用前可运行
php artisan vendor:publish --tag=laravel-errors生成默认模板(Laravel 8+ 默认已内置,但该命令能确保文件存在) - 如果目录不存在,手动创建
resources/views/errors并放入对应文件即可 - 模板中可正常使用 Blade 语法、
@include、@extends,比如继承你自己的layouts.app
为什么修改后 404 页面没变,但 500 页面正常?
常见原因是开发环境(APP_DEBUG=true)下,Laravel 会绕过 resources/views/errors/,直接显示 Whoops 错误详情页——这是设计行为,不是 bug。
- 404 是客户端错误,即使
APP_DEBUG=true也会走自定义视图(除非你触发的是路由未定义导致的“Whoops”式报错) - 500 是服务端异常,在
APP_DEBUG=true下**强制不走**500.blade.php,只显示调试堆栈;只有APP_DEBUG=false才会渲染它 - 验证方式:把
.env中的APP_DEBUG=false,然后用php artisan serve或 Nginx/Apache 访问一个真实会抛出异常的路由(如throw new \Exception('test');)
如何让错误页支持 CSS/JS 和布局复用?
直接在 404.blade.php 里用 @extends('layouts.app') 即可,和普通页面一样引用资源。但要注意:错误页是在异常上下文中渲染的,不能依赖可能已失效的服务或数据库连接。