所有未捕获异常最终均由 app\exceptions\handler 的 render() 方法处理，laravel 根据异常类型、ajax 请求及调试模式决定返回 json 或视图；app_debug=false 时自动渲染 resources/views/errors/{code}.blade.php，文件名须为纯数字加 .blade.php。
异常没被捕获时 Laravel 默认怎么处理
所有未被 try/catch 捕获的异常，最终都会落到 App\Exceptions\Handler 的 render() 方法里。Laravel 会根据异常类型、请求是否为 AJAX、是否在调试模式下，自动决定返回 JSON 还是视图页面。
关键点：不是所有异常都走 report()，但所有异常一定走 render() —— 这是你控制响应内容的唯一入口。
- 开发环境（
APP_DEBUG=true）下，直接显示 Whoops 错误页，不走自定义视图 - 生产环境（
APP_DEBUG=false）下，才会触发render()返回你配的错误页面 -
HttpException（比如 404、500）会被自动映射到resources/views/errors/404.blade.php等路径，但前提是这些文件存在且命名规范
如何让 404/500 错误显示自定义 Blade 页面
不用改路由，也不用写中间件。Laravel 会自动查找 resources/views/errors 下对应状态码的 Blade 文件，例如：404.blade.php、500.blade.php、419.blade.php。
注意：文件名必须是纯数字 + .blade.php，不能带下划线或大小写；Laravel 不会 fallback 到 5xx.blade.php 这类通配名。
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
- 确保
APP_DEBUG=false，否则永远看不到这些页面 - 文件里可以直接用
$exception变量（仅限 4xx/5xx 视图），但别依赖它输出敏感信息 - 如果用了多语言，不要在错误页里调用
__()或@lang—— 翻译服务可能已不可用 - 避免在错误页中引入外部 CSS/JS，推荐内联关键样式，防止资源加载失败导致页面空白
怎么拦截特定异常并返回不同响应
想对某个业务异常（比如 OrderNotFoundException）返回 404 页面，而不是默认 500，就得在 App\Exceptions\Handler@render 里手动干预。
别直接 throw 新异常，也别试图修改响应头后 return，Laravel 要求你 return 一个 Response 实例或字符串。
- 在
render()中用instanceof判断异常类型 - 用
response()->view('errors.custom-order', [], 404)显式返回视图 - 若需 JSON 响应（如 API 场景），用
response()->json(['message' => '...'], 404) - 别忘了在
report()里对这类异常做日志或告警 ——render()不负责记录
为什么自定义页面不生效？常见卡点
最常踩的不是代码写错，而是环境或路径没对上。
-
APP_DEBUG=true时死活不显示自定义页 —— 这是设计行为，不是 bug - 视图路径写成
errors/404.php（漏了.blade）或Errors/404.blade.php（大小写敏感，Linux 服务器会 404） - 缓存了视图：运行
php artisan view:clear，尤其改过 Blade 后 - 用了 Horizon/Swoole 等长生命周期服务，重启前旧逻辑仍生效
- 在
render()里写了dd()或抛出新异常，导致流程中断，根本没走到返回逻辑
复杂点在于：异常处理链路横跨 HTTP 生命周期、队列、命令行三种上下文，而 Handler 类只管 HTTP 请求。队列任务里的异常不会进这里，得单独处理。
