使用 Laravel 和 Passport 在身份验证失败时响应状态码 401？

Question

我正在配置一个 Laravel 项目以使用 Passport 令牌身份验证。一切似乎都在工作，但是当auth:api 中间件失败时，它会以200 的状态和响应正文中的一堆HTML 响应客户端。相反，我希望它以401 的状态响应。

我在 Laravel Passport 源代码或文档中找不到有关执行此类操作的任何内容。我什至找不到中间件的来源。

我的测试路线：

Route::get('/protected', function () {
    return response()->json([
        'success' => true
    ]);
})->middleware('auth:api');

配置/auth.php

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],

    'api' => [
        'driver' => 'passport',
        'provider' => 'appUsers',
    ],
],

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],

    'appUsers' => [
        'driver' => 'eloquent',
        'model' => App\Models\AppUser::class
    ],
],

Answer 1

在中间件中你可以这样返回：

return abort(401);

Answer 2

如果用户没有进行身份验证，Laravel 会抛出一个AuthenticationException。

此异常由Illuminate/Foundation/Exceptions/Handler.php 中的render 方法处理，并依次调用您的app/Exceptions/Handler.php 中定义的unauthenticated() 方法：

protected function unauthenticated($request, AuthenticationException $exception)
{
    if ($request->expectsJson()) {
        return response()->json(['error' => 'Unauthenticated.'], 401);
    }

    return redirect()->guest(route('login'));
}

如您所见，默认情况下，如果请求需要 JSON 响应，您将收到带有 JSON 错误正文的 401。如果请求不期望 JSON，则将请求重定向到登录页面。

如果您的请求具有Accept: application/json 标头或X-Requested-With: XMLHttpRequest，则expectsJson() 方法将返回true。 Accept: application/json 标头更适合 api 调用，而 X-Requested-With: XMLHttpRequest 标头用于 ajax 调用。

因此，无需更改任何应用程序代码，只需确保请求包含 Accept: application/json 标头即可。

但是，如果您需要在用户未通过身份验证时执行不同的操作，您可以在app/Exceptions/Handler.php 中修改此unauthenticated() 方法：

protected function unauthenticated($request, AuthenticationException $exception)
{
    if ($request->expectsJson()) {
        return response()->json(['error' => 'Unauthenticated.'], 401);
    }

    // return a plain 401 response even when not a json call
    return response('Unauthenticated.', 401);
}

Answer 3

您可以通过在请求中发送此标头来解决它。

Accept : application/json

这将发送带有401 状态码的消息。

{
    "message": "Unauthenticated."
}