Laravel Sanctum登录API返回200状态码但无内容问题排查

问题核心分析 #

从你提供的代码来看，登录成功时返回空响应、错误凭证时正常返回401的现象，主要由以下几个关键点导致：

1. 异常处理不完整 #

AuthController的login方法中，catch块仅处理了AuthenticationException，其他异常（如类不存在、序列化失败等）被捕获后没有返回任何响应，Laravel会默认返回200空内容。

2. 请求参数键名可能不匹配 #

AuthService中调用comparePassword时使用了$request['hasło']（波兰语“密码”），若你的登录请求参数是英文password，会导致密码校验失败触发异常；但你提到正确输入时返回空响应，大概率是其他异常未被处理导致。

3. UserResource未正确定义 #

如果UserResource类不存在或未配置返回字段，会触发序列化异常，而该异常未被处理，最终导致空响应。

具体修复步骤 #

1. 完善异常处理逻辑 #

修改AuthController.php的login方法，确保所有异常都能返回明确响应：

public function login(LoginRequest $request)
{
    try 
    {
        $res = $this->authService->loginUser($request);
        return response()->json($res, 200); // 改用json方法明确返回JSON，状态码遵循REST规范
    } 
    catch(AuthenticationException $e)
    {
        return response()->json(['message' => 'Nieprawidłowy adres email lub hasło!'], 401);
    }
    catch(Exception $e)
    {
        // 记录错误日志便于排查
        \Log::error('登录错误详情: '.$e->getMessage());
        return response()->json(['message' => 'Wystąpił błąd podczas logowania!'], 500);
    }
}

2. 统一请求参数键名 #

确保请求参数与代码调用一致：

• 若登录请求用英文password，修改AuthService.php的loginUser方法：

$isCorrectPassword = $this->userRepository->comparePassword($request['password'], $user);

• 同时检查LoginRequest.php的验证规则，确保字段匹配：

// LoginRequest.php示例规则
public function rules()
{
    return [
        'email' => 'required|email',
        'password' => 'required|string',
    ];
}

3. 检查并完善UserResource #

确保UserResource类存在且配置返回字段，示例如下：

// app/Http/Resources/UserResource.php
<?php

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class UserResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'email' => $this->email,
            // 添加其他需要返回的用户字段
        ];
    }
}

4. 优化Repository方法（可选） #

调整UserRepository.php的findByEmail方法，符合Repository模式规范：

public function findByEmail(string $email)
{
    return $this->user->where('email', $email)->first();
}

验证测试 #

1. 确保请求参数键名与代码一致（如email和password）；
2. 登录成功时，将返回包含用户信息与token的JSON响应，状态码200；
3. 凭证错误时，返回401与对应提示；
4. 其他错误会返回500通用提示，同时日志记录详细错误信息。

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