在 Laravel 项目里，前后台的用户群体不同，对错误页面的需求也存在差异，前台需要简洁易懂的提示，后台可能需要更详细的错误信息方便排查问题，因此实现前后台差异化的错误页面是很有必要的。
核心实现思路
Laravel 的异常处理由 AppExceptionsHandler 类负责，我们可以通过判断当前请求的路由是否属于后台前缀，在异常渲染阶段返回不同的错误视图，同时可以自定义异常类来传递更丰富的错误信息。
步骤一：区分前后台请求
首先需要在项目中定义前后台的路由前缀，比如后台路由统一使用 admin 前缀，然后通过中间件或者直接在异常处理器中判断请求路径是否包含该前缀。
假设我们的后台路由都定义在 routes/admin.php 中，并且统一添加了 admin 前缀，那么可以通过下面的方式判断请求是否属于后台：
<?php
// 在异常处理器中判断是否为后台请求的方法
protected function isAdminRequest($request)
{
// 判断请求路径是否以 /admin 开头
return $request->is('admin/*') || $request->is('admin');
}
步骤二：自定义异常处理器渲染逻辑
打开 app/Exceptions/Handler.php 文件，重写 render 方法，在方法中根据前后台请求类型返回不同的错误视图。
<?php
namespace AppExceptions;
use IlluminateFoundationExceptionsHandler as ExceptionHandler;
use Throwable;
use IlluminateHttpRequest;
use SymfonyComponentHttpKernelExceptionHttpException;
class Handler extends ExceptionHandler
{
// 其他原有代码...
public function render($request, Throwable $exception)
{
// 如果是 HTTP 异常，处理错误页面差异化
if ($exception instanceof HttpException) {
$statusCode = $exception->getStatusCode();
// 判断是否为后台请求
if ($this->isAdminRequest($request)) {
// 后台错误页面视图路径：resources/views/admin/errors/
$viewPath = "admin.errors.{$statusCode}";
// 判断视图是否存在，不存在则使用默认的后台错误模板
if (view()->exists($viewPath)) {
return response()->view($viewPath, [
'exception' => $exception,
'message' => $exception->getMessage() ?: '后台操作出现异常'
], $statusCode);
}
} else {
// 前台错误页面视图路径：resources/views/errors/
$viewPath = "errors.{$statusCode}";
if (view()->exists($viewPath)) {
return response()->view($viewPath, [
'exception' => $exception,
'message' => $exception->getMessage() ?: '页面暂时无法访问'
], $statusCode);
}
}
}
// 其他异常走原有处理逻辑
return parent::render($request, $exception);
}
protected function isAdminRequest($request)
{
return $request->is('admin/*') || $request->is('admin');
}
}
步骤三：创建对应的错误页面视图
按照上面的逻辑，我们需要在视图目录下分别创建前后台的错误页面，常见的 HTTP 错误状态码比如 404、500、403 都需要单独创建对应的视图文件。
前台错误页面
在 resources/views/errors/ 目录下创建对应状态码的视图文件，比如 404.blade.php：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>页面未找到</title>
<style>
.error-container {
text-align: center;
padding: 100px 20px;
}
.error-code {
font-size: 80px;
color: #333;
}
.error-msg {
font-size: 20px;
color: #666;
margin-top: 20px;
}
</style>
</head>
<body>
<div class="error-container">
<div class="error-code">404</div>
<div class="error-msg">{{ $message }}</div>
<a href="/">返回首页</a>
</div>
</body>
</html>
后台错误页面
在 resources/views/admin/errors/ 目录下创建对应状态码的视图文件，比如 404.blade.php，后台页面可以展示更多调试信息：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>后台错误</title>
<style>
.error-container {
padding: 40px;
max-width: 1200px;
margin: 0 auto;
}
.error-code {
font-size: 60px;
color: #dc3545;
}
.error-info {
margin-top: 30px;
padding: 20px;
background: #f8f9fa;
border-radius: 4px;
}
</style>
</head>
<body>
<div class="error-container">
<div class="error-code">错误码：{{ $exception->getStatusCode() }}</div>
<div class="error-info">
<p>错误信息：{{ $message }}</p>
<p>请求路径：{{ request()->fullUrl() }}</p>
</div>
<a href="{{ url('admin/dashboard') }}">返回后台首页</a>
</div>
</body>
</html>
步骤四：处理自定义异常
如果项目中存在自定义的业务异常，也可以在异常处理器中统一处理，比如定义一个 AdminException 专门用于处理后台相关的异常：
<?php
namespace AppExceptions;
use Exception;
class AdminException extends Exception
{
protected $statusCode;
public function __construct($message = '', $statusCode = 403)
{
parent::__construct($message);
$this->statusCode = $statusCode;
}
public function getStatusCode()
{
return $this->statusCode;
}
}
然后在 render 方法中添加对应的处理逻辑，确保自定义异常也能返回正确的前后台差异化页面。
注意事项
- 如果后台使用了独立的域名，判断逻辑可以改为判断当前请求的域名是否为后台域名，适配更灵活的场景。
- 生产环境下建议关闭后台错误页面的详细调试信息展示，避免敏感信息泄露。
- 可以针对不同的异常类型做更细致的判断，比如数据库异常、验证异常等，返回更贴合场景的提示内容。