Laravel怎么处理404错误_Laravel自定义错误页面设置【说明】-Laravel-PHP中文网

Laravel 404页面不生效的根本原因是APP_DEBUG=true时强制返回调试堆栈，生产环境才加载resources/views/errors/404.blade.php；需确保APP_DEBUG=false、配置清除、Nginx正确配置try_files，并在Handler中捕获NotFoundHttpException传参及记录日志。

laravel怎么处理404错误_laravel自定义错误页面设置【说明】

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-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

实操建议：

检查 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;
}