Laravel自定义错误页面需满足APP_DEBUG=false、异常经Handler::render()处理并映射正确状态码，且视图路径准确；否则仍显示调试页或白屏。
直接说结论：Laravel 的异常处理核心在 App\Exceptions\Handler 类，自定义错误页面不是改视图文件就能生效，必须配合异常类型判断、HTTP 状态码映射和环境配置才可靠。
如何让 404/500 错误显示自定义页面
Laravel 默认在 resources/views/errors/ 下查找对应状态码的 Blade 模板（如 404.blade.php、500.blade.php），但前提是异常最终被转换为 HTTP 响应且状态码明确：
-
路由未匹配触发的
NotFoundHttpException→ 自动映射到404.blade.php - 代码中手动抛出
abort(500)或未捕获的致命错误 → 触发500.blade.php -
APP_DEBUG=true时，无论什么错误都显示调试页面，404.blade.php不会渲染 —— 这是新手最常忽略的点 - 模板里可安全使用
$exception变量（例如{{ $exception->getMessage() }}），但生产环境建议隐藏敏感信息
如何在 Handler 中区分处理不同异常
App\Exceptions\Handler 的 render() 方法是拦截入口，它决定异常是否转为响应、返回什么内容、是否记录日志：
- 用
instanceof判断异常类型比检查错误消息更可靠，例如：if ($exception instanceof \Illuminate\Database\Eloquent\ModelNotFoundException) { return response(view('errors.404'), 404); } - 不要在
render()里写复杂逻辑或数据库操作 —— 异常发生时环境可能已不稳定 - 对 API 请求（
request()->expectsJson()）应返回 JSON 错误结构，而非 HTML 页面 - 自定义异常类（如
PaymentFailedException）需显式注册到$dontReport或$dontFlash数组，否则可能被重复记录
为什么有时候自定义页面不生效
常见失效场景和对应排查点：
-
APP_ENV=local且APP_DEBUG=true→ 强制显示 Whoops 调试页，关掉DEBUG才走自定义视图 - 抛出的是 PHP 致命错误（如
Fatal error: Class 'XXX' not found）→ 不经过Handler::render()，无法被拦截，只能靠register()中的set_error_handler补救 - 视图路径写错，比如把
resources/views/errors/404.blade.php误建为resources/views/errors/404.php→ Laravel 不识别，回退到默认白屏 - Nginx/Apache 配置了
error_page 404 /404.html→ Web 服务器层提前截获，根本没进 Laravel
真正麻烦的不是加个视图文件，而是异常从抛出到渲染中间经过了框架多层转换，每一步都有开关控制。别只盯着 Blade 文件，先确认 APP_DEBUG、请求头、Web 服务器配置和 Handler 里的分支逻辑是否全部对齐。
