laravel在app_debug=true时强制显示symfony调试页，跳过resources/views/errors/404.blade.php；必须设app_debug=false、清配置缓存、确保nginx正确转发且视图路径准确，才生效。
APP_DEBUG=true 时 404 页面根本不会渲染
开发阶段看到白屏或调试堆栈，不是页面写错了，而是 Laravel 直接跳过了 resources/views/errors/404.blade.php。只要 APP_DEBUG=true，所有 HTTP 异常（包括 NotFoundHttpException）都会走 Symfony 调试器，而不是你的自定义视图。
实操建议：
- 本地调试时可临时设为
APP_DEBUG=false，再运行php artisan config:clear确保生效 - 别在
.env里反复开关——改完必须清配置缓存，否则旧值仍被读取 - 若需保留调试信息又想预览 404 页面，可在
app/Exceptions/Handler.php的render()方法里手动拦截：if ($exception instanceof NotFoundHttpException) { return response()->view('errors.404', [], 404); }
Route::fallback() 是唯一能访问 session/auth 的 404 替代方案
resources/views/errors/404.blade.php 是异常处理器直接渲染的，不经过中间件，所以拿不到 auth()、session()、甚至 url() 辅助函数都可能报错。而 Route::fallback() 是真实路由，会完整执行 web 中间件栈。
实操建议：
- 在
routes/web.php底部加：Route::fallback(function () { return view('notFound'); }); - 确保该路由放在所有其他路由之后，否则会提前匹配、吞掉合法请求
- 不要给它命名（如
->name('fallback')），因为Route::respondWithRoute('fallback')在新版本中已废弃，Laravel 5.5.10+ 只支持匿名闭包或控制器方法 - 如果用了多语言或租户隔离，记得在
notFound视图里避免调用依赖上下文的 helper（比如route('home')），改用硬编码路径或从$request提取前缀
API 和 Web 的 404 必须分开处理
/api/users/999 和 /non-existing-page 都是 404，但前者该返回 JSON，后者该返回 HTML 页面。共用一个 fallback 会导致前端解析失败或 SEO 混乱。
实操建议：
- 在
routes/api.php末尾单独定义：Route::fallback(function () { return response()->json(['message' => 'Not Found'], 404); }); - 这个
fallback只捕获带/api前缀且无匹配的请求，不会干扰 web 路由 - 不要试图在 web 的
fallback里做if ($request->is('api/*'))判断——此时请求已进入 web 中间件组，auth可能已触发重定向，逻辑不可控 - 检查
app/Providers/RouteServiceProvider.php中是否对 API 组正确设置了prefix和middleware，否则api.php的fallback不生效
修改错误页后没变化？先盯死三件事
常见“改了文件却没效果”问题，90% 出在缓存、路径或 Nginx 配置上，跟代码逻辑无关。
实操建议：
- 执行
php artisan view:clear—— Blade 编译缓存不自动更新，尤其生产环境 - 确认文件路径是
resources/views/errors/404.blade.php，不是resources/views/404.blade.php或resources/views/errors/404.php - Nginx 用户必须检查
try_files：要写成try_files $uri $uri/ /index.php?$query_string;，不能是=404，否则请求根本到不了 Laravel - 如果用了子域名或 HTTPS 重定向中间件，确保它们不会在 404 前就终止请求（例如未登录用户被 redirect 到 login，导致 404 被跳过）
