Laravel项目中如何为后台与前台指定对应错误页面？

嘿，这个需求在Laravel里完全可以通过定制异常处理器来实现，我给你分步骤讲清楚怎么做，两种方式供你选，推荐更灵活的那种：

1. 给后台请求打标记（推荐方案：中间件方式） #

为了准确区分后台和前台请求，我们可以给所有后台路由加一个专属中间件，用来标记当前请求属于后台。这种方式比直接判断路由前缀更灵活，哪怕以后后台路由前缀变更，也不用到处改代码。

• 生成中间件：
  运行Artisan命令创建中间件：

  php artisan make:middleware MarkAdminRequest
  

• 编辑中间件逻辑：
  打开生成的app/Http/Middleware/MarkAdminRequest.php，修改handle方法，给请求添加后台标记：

  <?php
  
  namespace App\Http\Middleware;
  
  use Closure;
  use Illuminate\Http\Request;
  
  class MarkAdminRequest
  {
      public function handle(Request $request, Closure $next)
      {
          // 给请求设置属性，标记这是后台请求
          $request->attributes->set('is_admin', true);
          return $next($request);
      }
  }
  

• 注册中间件：
  打开app/Http/Kernel.php，在$routeMiddleware数组中添加这个中间件：

  protected $routeMiddleware = [
      // ... 其他已有的中间件
      'admin.mark' => \App\Http\Middleware\MarkAdminRequest::class,
  ];
  

• 给后台路由应用中间件：
  前往routes/web.php，把所有后台路由放到带有该中间件的路由组里：

  Route::prefix('admin')->middleware(['web', 'admin.mark'])->group(function () {
      // 这里放置你的所有后台路由，比如登录、仪表盘、数据管理等
  });
  

2. 定制异常处理器，返回对应错误页面 #

Laravel的异常处理核心在app/Exceptions/Handler.php，我们需要在这里根据请求的后台标记，返回不同的自定义错误视图。

打开这个文件，在register方法中添加以下逻辑（记得导入对应的异常类，若编辑器未自动导入，手动添加到文件顶部即可）：

<?php

namespace App\Exceptions;

use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
use Illuminate\Auth\Access\AuthorizationException;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
use Symfony\Component\HttpKernel\Exception\HttpException;
use Throwable;

class Handler extends ExceptionHandler
{
    // ... 文件中默认的其他代码

    public function register()
    {
        // 处理404页面不存在异常
        $this->renderable(function (NotFoundHttpException $e, $request) {
            if ($request->attributes->get('is_admin')) {
                return response()->view('admin.404-admin', [], 404);
            }
            return response()->view('site.404', [], 404);
        });

        // 处理403权限不足异常
        $this->renderable(function (AuthorizationException $e, $request) {
            if ($request->attributes->get('is_admin')) {
                return response()->view('admin.403-admin', [], 403);
            }
            // 若前台也需要自定义403页面，可修改为你的前台视图，否则用默认即可
            return response()->view('site.403', [], 403);
        });

        // 处理500服务器错误异常
        $this->renderable(function (HttpException $e, $request) {
            if ($e->getStatusCode() === 500 && !$request->attributes->get('is_admin')) {
                return response()->view('site.500', [], 500);
            }
            // 若需要后台自定义500页面，取消下面注释并创建对应视图即可
            // if ($e->getStatusCode() === 500 && $request->attributes->get('is_admin')) {
            //     return response()->view('admin.500-admin', [], 500);
            // }
        });
    }
}

备选方案：通过路由前缀直接判断（简单但灵活性弱） #

如果你不想用中间件，也可以直接通过请求路径判断是否为后台请求（比如后台路由都是/admin/*开头），只需把上面代码中的$request->attributes->get('is_admin')替换为str_starts_with($request->path(), 'admin')即可，示例：

$this->renderable(function (NotFoundHttpException $e, $request) {
    if (str_starts_with($request->path(), 'admin')) {
        return response()->view('admin.404-admin', [], 404);
    }
    return response()->view('site.404', [], 404);
});

这种方式无需添加中间件，但如果以后后台路由前缀变更，就得修改这里的判断代码，所以更推荐中间件方案。

测试注意事项 #

记得把.env文件中的APP_DEBUG设为false，因为Laravel在调试模式下会显示详细的错误堆栈信息，不会触发我们的自定义错误页面，只有关闭调试模式（生产环境状态）才会显示自定义视图。

内容的提问来源于stack exchange，提问作者Jorge Omar Tovar Martínez