Laravel怎么自定义错误页面_Laravel修改404和500报错样式【实战】-Laravel

直接修改 resources/views/errors/404.blade.php 和 500.blade.php 即可自定义错误页,Laravel 自动加载;但 APP_DEBUG=true 时 500 页被 Whoops 替代,需设为 false 才生效,404 页在调试模式下仍生效。

如何在 Laravel 中替换默认的 404 和 500 错误页面

直接改 resources/views/errors/404.blade.php 和 resources/views/errors/500.blade.php 就行。Laravel 会自动优先加载这两个文件,无需额外配置或注册。

注意:这两个文件必须放在 resources/views/errors/ 目录下,且文件名严格为 404.blade.php、500.blade.php(大小写敏感),否则不生效。

  • 首次使用前可运行 php artisan vendor:publish --tag=laravel-errors 生成默认模板(Laravel 8+ 默认已内置,但该命令能确保文件存在)
  • 如果目录不存在,手动创建 resources/views/errors 并放入对应文件即可
  • 模板中可正常使用 Blade 语法、@include、@extends,比如继承你自己的 layouts.app

为什么修改后 404 页面没变,但 500 页面正常?

常见原因是开发环境(APP_DEBUG=true)下,Laravel 会绕过 resources/views/errors/,直接显示 Whoops 错误详情页——这是设计行为,不是 bug。

  • 404 是客户端错误,即使 APP_DEBUG=true 也会走自定义视图(除非你触发的是路由未定义导致的“Whoops”式报错)
  • 500 是服务端异常,在 APP_DEBUG=true 下**强制不走** 500.blade.php,只显示调试堆栈;只有 APP_DEBUG=false 才会渲染它
  • 验证方式:把 .env 中的 APP_DEBUG=false,然后用 php artisan serve 或 Nginx/Apache 访问一个真实会抛出异常的路由(如 throw new \Exception('test');)

如何让错误页支持 CSS/JS 和布局复用?

直接在 404.blade.php 里用 @extends('layouts.app') 即可,和普通页面一样引用资源。但要注意:错误页是在异常上下文中渲染的,不能依赖可能已失效的服务或数据库连接。

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » Laravel怎么自定义错误页面_Laravel修改404和500报错样式【实战】-Laravel
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4012859+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1392+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4012859+
  • 本周更新: 0+
  • 最后更新: 2026-03-16