Laravel 404页面不生效的根本原因是APP_DEBUG=true时强制返回调试堆栈，生产环境才加载resources/views/errors/404.blade.php；需确保APP_DEBUG=false、配置清除、Nginx正确配置try_files，并在Handler中捕获NotFoundHttpException传参及记录日志。
404页面不生效，访问不存在路由仍显示默认白屏
根本原因通常是 APP_DEBUG=true 开启时，Laravel 会强制返回调试堆栈而非自定义视图。生产环境才走 resources/views/errors/404.blade.php 流程。
实操建议：
- 确认
.env中APP_DEBUG=false，且已运行php artisan config:clear - 确保视图路径严格为
resources/views/errors/404.blade.php（注意是errors目录，不是error或404子目录） - 如果用了多语言或子域名，检查中间件是否提前终止了请求（比如权限中间件在未登录时 redirect 到 login，导致 404 被绕过）
想给404页面传参（如错误ID、跳转来源）
Laravel 默认不提供参数注入机制，404.blade.php 是纯静态渲染，不能直接访问 $request 或 $exception —— 因为它由异常处理器统一渲染，但没把上下文透传进来。
实操建议：
- 在
app/Exceptions/Handler.php的render()方法里捕获NotFoundHttpException，手动传参：if ($exception instanceof NotFoundHttpException) { return response()->view('errors.404', [ 'error_id' => uniqid('err_'), 'referer' => $request->headers->get('referer'), ], 404); } - 避免在视图里调用
url()或route()等辅助函数做重定向逻辑——404 页面应保持无副作用，否则可能掩盖真实问题
部署到 Nginx 后 404 总被 Web 服务器拦截，Laravel 根本没机会处理
Nginx 默认配置下，当请求的文件或路径不存在时，会直接返回 Nginx 自己的 404，根本不会转发给 Laravel 的 index.php 入口。
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
实操建议：
- 检查 Nginx 配置中是否有类似
try_files $uri $uri/ /index.php?$query_string;这一行，缺了就会跳过 Laravel - 不要写成
try_files $uri $uri/ =404;—— 这等于告诉 Nginx：“找不到就自己报错”，Laravel 彻底失权 - 如果用了子目录部署（如
/myapp），try_files要对应调整，否则所有请求都 404
需要记录 404 请求日志，但不想污染正常 error log
直接改写 Handler.php 的 report() 方法最轻量，比加中间件或监听事件更可控，也避免误记爬虫试探性请求。
实操建议：
- 在
report()中判断异常类型：if ($exception instanceof NotFoundHttpException) { \Log::channel('daily')->warning('404 Not Found', [ 'path' => $request->fullUrl(), 'method' => $request->method(), 'ip' => $request->ip(), ]); return; } - 别用
Log::emergency()或error()—— 它们会触发 Slack/Webhook 告警，404 不该算紧急事件 - 如果日志量大，考虑加简单频率限制（例如每分钟最多记 10 条相同 path），防止刷爆磁盘
真正麻烦的是混合场景：前端路由（如 Vue Router）和后端路由共存时，/admin/foo 404 可能来自 JS 路由 fallback，也可能来自 Laravel 路由未定义，得先分清源头再动手。
