Laravel中Client模型自定义Guard登录后无法保持认证问题求助

你遇到的问题核心是Client模型未满足Laravel认证系统的要求，或会话序列化出现异常，导致跨请求时无法恢复认证状态。以下是具体排查和修复步骤：

1. 确保Client模型实现认证接口 #

Laravel的认证模型必须实现Illuminate\Contracts\Auth\Authenticatable接口，或直接继承Illuminate\Foundation\Auth\User基类（推荐），否则会话无法正确序列化/反序列化用户实例。

修改App\Models\Client.php：

<?php

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;

class Client extends Authenticatable
{
    // 根据你的数据表字段调整填充属性
    protected $fillable = [
        'name', 'email', 'password',
    ];

    protected $hidden = [
        'password', 'remember_token',
    ];
}

若不想继承基类，也可手动实现接口并引入Authenticatable trait：

use Illuminate\Database\Eloquent\Model;
use Illuminate\Contracts\Auth\Authenticatable;
use Illuminate\Auth\Authenticatable as AuthenticatableTrait;

class Client extends Model implements Authenticatable
{
    use AuthenticatableTrait;

    // 你的模型逻辑
}

2. 检查路由中间件顺序 #

确保web中间件组（包含StartSession中间件）在auth:client之前执行，否则会话未启动就会触发认证检查。

路由需放在web中间件组内（默认routes/web.php已自动应用该组，自定义路由文件需手动确认）：

Route::middleware(['web', 'auth:client'])->group(function () {
    Route::get('/my-orders', [ClientOrderController::class, 'index']);
});

3. 验证会话存储与序列化 #

• 若Client模型有自定义serialize()/unserialize()方法，需确保未破坏认证所需字段（如id、remember_token）。
• 检查.env文件的SESSION_DRIVER配置，确保使用的驱动（如file、database）正常工作，且storage/framework/sessions目录有读写权限。

4. 确认登录逻辑的正确性 #

虽然当前请求能获取用户，但可在登录后显式保存会话，确保数据持久化：

Auth::guard('client')->loginUsingId($client->id, true);
session()->save(); // 强制保存会话
return redirect('/my-orders');

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