Laravel Spatie权限：未授权用户重定向报错及实现需求

我之前也踩过这个坑，这个错误本质上是因为你的异常处理代码没有返回一个有效的Laravel响应实例，导致框架尝试在null上调用setCookie方法。下面是一步步的解决方案：

第一步：正确配置异常处理逻辑 #

根据你的Laravel版本，选择对应的写法：

适用于Laravel 8+（推荐） #

在app/Exceptions/Handler.php的register方法中添加renderable闭包，专门处理Spatie的未授权异常：

use Spatie\Permission\Exceptions\UnauthorizedException;

public function register()
{
    $this->renderable(function (UnauthorizedException $e, $request) {
        // 区分API请求和网页请求，返回不同响应
        if ($request->expectsJson()) {
            return response()->json(['message' => $e->getMessage()], 403);
        }

        // 返回自定义未授权视图，带上上一页的URL
        return response()->view('errors.unauthorized', [
            'previousUrl' => url()->previous()
        ], 403);
    });
}

适用于Laravel 7及以下 #

如果你的项目是旧版本，可以重写render方法，但一定要记得调用父类的render作为兜底：

public function render($request, Exception $exception)
{
    if ($exception instanceof \Spatie\Permission\Exceptions\UnauthorizedException) {
        if ($request->expectsJson()) {
            return response()->json(['message' => $exception->getMessage()], 403);
        }
        
        return response()->view('errors.unauthorized', [
            'previousUrl' => url()->previous()
        ], 403);
    }

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

第二步：创建自定义未授权视图 #

在resources/views/errors目录下新建unauthorized.blade.php文件，添加以下内容（可以根据你的项目样式自定义）：

<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>未授权访问</title>
    <style>
        .auth-error-container {
            max-width: 600px;
            margin: 120px auto;
            text-align: center;
            padding: 30px;
            border-radius: 8px;
            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
        }
        .btn-back {
            display: inline-block;
            margin-top: 20px;
            padding: 10px 24px;
            background-color: #2563eb;
            color: white;
            text-decoration: none;
            border-radius: 4px;
            transition: background-color 0.2s;
        }
        .btn-back:hover {
            background-color: #1d4ed8;
        }
    </style>
</head>
<body>
    <div class="auth-error-container">
        <h1>权限不足</h1>
        <p>{{ $exception->getMessage() ?? '您没有访问该页面的权限，请联系管理员' }}</p>
        @if($previousUrl)
            <a href="{{ $previousUrl }}" class="btn-back">返回上一页</a>
        @else
            <a href="{{ url('/') }}" class="btn-back">返回首页</a>
        @endif
    </div>
</body>
</html>

为什么之前的代码会报错？ #

你遇到的Call to a member function setCookie() on null错误，通常是因为：

1. 没有用response()->view()包装视图返回，而是直接返回view()（虽然大部分时候没问题，但在异常处理的上下文里可能导致响应实例不完整）
2. 没有处理API请求的情况，当API请求触发未授权异常时，返回视图会导致响应格式错误
3. 忘记调用父类的render方法（针对旧版本重写render的情况），导致其他异常无法被正常处理

内容的提问来源于stack exchange，提问作者Pranav Mandlik