laravel如何自定义404和500错误页面_Laravel自定义404与500错误页面方法-Laravel-PHP中文网

laravel如何自定义404和500错误页面_Laravel自定义404与500错误页面方法

冰火之心

发布： 2025-10-21 12:28:03

原创

407人浏览过

Laravel自定义404和500页面只需在resources/views/errors/下创建对应状态码的Blade文件，如404.blade.php和500.blade.php，系统会自动渲染；通过abort(404)或abort(500)测试，确保APP_DEBUG=false并清除视图缓存即可生效。

laravel如何自定义404和500错误页面_laravel自定义404与500错误页面方法

Laravel 自定义 404 和 500 错误页面非常简单，只需要在 resources/views/errors/ 目录下创建对应状态码的 Blade 模板文件即可。Laravel 会自动根据 HTTP 状态码渲染相应的错误页面。

1. 创建自定义错误页面模板

Laravel 使用 resources/views/errors/ 文件夹来存放所有错误页面视图。你只需在此目录下创建与状态码同名的 Blade 文件：

404.blade.php —— 页面未找到
500.blade.php —— 服务器内部错误
其他如 403、419 等也可按需创建

例如，创建自定义 404 页面：

<div style="text-align: center; margin-top: 50px;">
<h1>抱歉，您访问的页面不存在！</h1>
<a href="{{ url('/') }}">返回首页</a>
</div>

再比如，创建 500 页面：

<div style="text-align: center; margin-top: 50px;">
<h1>服务器开小差了，请稍后再试！</h1>
<p>错误代码：500</p>
</div>

2. 测试错误页面

为了查看效果，可以在路由中手动触发异常：

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

Route::get('/test-404', function () {
abort(404);
});

Route::get('/test-500', function () {
abort(500);
});

访问 /test-404 或 /test-500 就能看到你自定义的页面。

3. 全局异常处理（可选）

如果你需要更精细地控制异常响应，可以编辑 app/Exceptions/Handler.php 中的 render() 方法：

public function render($request, Throwable \$exception)
{
  if ($exception instanceof \Illuminate\Foundation\Http\Exceptions\MaintenanceModeException) {
    return parent::render($request, $exception);
  }

return parent::render($request, $exception);
}

一般情况下无需修改此文件，Laravel 默认会优先查找 resources/views/errors/ 下的视图。