自定义404/500页面需严格满足三要素：文件必须置于resources/views/errors/下、命名为404.blade.php或500.blade.php、且APP_DEBUG=false时才生效；Nginx需配置try_files正确转发请求，否则错误页根本不会触发。
自定义 404 和 500 页面本身不难，但多数人卡在“改了没反应”——根本原因是路径、环境或服务器配置三者中至少一个没对上，而不是 Blade 写得不够好。
resources/views/errors/ 下的文件名和路径必须完全匹配
Laravel 只识别 resources/views/errors/404.blade.php 和 resources/views/errors/500.blade.php 这两个确切路径+文件名。大小写敏感，后缀必须是 .blade.php，不能是 .php 或 .html。
- 错例：
resources/views/404.blade.php（缺errors/子目录）→ 不加载 - 错例：
resources/views/errors/NotFound.blade.php→ Laravel 完全忽略 - 错例：
resources/views/errors/404.php→ 视为普通 PHP 文件，不走 Blade 编译 - 创建前先确保目录存在：
mkdir -p resources/views/errors
APP_DEBUG=false 才会真正渲染自定义页面
开发时设 APP_DEBUG=true，Laravel 强制显示 Symfony 的调试页（Whoops），404.blade.php 和 500.blade.php 完全不参与渲染——这不是 bug，是设计使然。
- 测试前务必确认
.env中是APP_DEBUG=false - 改完
.env后运行php artisan config:clear，否则缓存可能让设置失效 - 别用
abort(404)在本地测：它在APP_DEBUG=true下仍跳 Whoops；临时切到false再刷浏览器更可靠
Nginx/Apache 配置错误会导致 404 根本进不了 Laravel
如果访问任意不存在路由都直接看到 Web 服务器原生的 “404 Not Found”，说明请求压根没交给 Laravel 处理，errors/ 目录再正确也没用。
- Nginx 必须有这行：
try_files $uri $uri/ /index.php?$query_string; - 错例：
try_files $uri $uri/ =404;→ Nginx 自己返回 404，Laravel 零机会介入 - 子目录部署（如
/myapp）时，try_files要改成/myapp/index.php?$query_string - Apache 需启用
mod_rewrite，且项目根目录下.htaccess未被覆盖或禁用
静态资源失效、url() 渲染为空？别依赖运行时上下文
错误页面是在异常中断后渲染的，部分服务（如 URL 生成器、Session、Auth）可能已不可用。硬编码路径比调用辅助函数更稳。
-
{{ asset('css/app.css') }}可能输出空字符串或相对路径 → 改用<link rel="stylesheet" href="/css/app.css"> -
{{ url('/login') }}不可靠 → 用<a href="/login">登录</a> - 若必须动态拼接，加判空兜底：
{{ url('/home') ?: '/home' }} - 继承布局（如
@extends('layouts.app')）可以，但确保layouts.app里不调用Auth::user()或未初始化的$user变量
最常被忽略的一点：500 页面在某些致命错误（如语法错误、类加载失败）下根本不会执行——因为异常发生在 Laravel 启动之前，连视图引擎都没加载。这种情况下你看到的是框架内置 fallback，不是你的 500.blade.php。真要覆盖这类错误，得去改 PHP 的 register_shutdown_function 或 Web 服务器级错误页。
