Laravel修改注册登录默认数据表遇SessionGuard构造参数错误的解决

架构老林

2026-7-30

Laravel自定义认证表报错解决方法

你遇到的错误是因为web guard中指定的provider（Utilisateur）未在配置文件的providers部分定义，同时guards配置里的table字段是多余的——Laravel认证guard不直接读取table配置，而是通过provider关联模型与数据表。

具体修改步骤：

补充providers配置项
在config/auth.php中添加对应自定义模型的用户提供者，确保provider键名与guards中指定的一致（建议用小写避免大小写问题）：

return [
    // ... 其他配置
    
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\Models\User::class,
        ],
        // 添加自定义提供者
        'utilisateurs' => [
            'driver' => 'eloquent',
            'model' => App\Models\Utilisateur::class, // 替换为你的模型实际路径
        ],
    ],
];

修正guards配置
移除多余的table字段，将provider指向刚定义的提供者键名：

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'utilisateurs', // 与providers中的键名一致
    ],
],

更新默认密码重置配置
修改defaults中的password选项，确保密码重置功能关联自定义提供者：
```
'defaults' => [
    'guard' => 'web',
    'password' => 'utilisateurs', // 与providers中的键名一致
],
```

确保模型符合认证要求
检查Utilisateur模型是否继承Laravel认证基类，实现必要接口：

<?php

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class Utilisateur extends Authenticatable
{
    use Notifiable;

    // 指定自定义数据表名（若模型名与表名不符合Laravel默认规则）
    protected $table = 'Utilisateurs';

    // 配置可填充字段、隐藏字段等
    protected $fillable = [
        'name', 'email', 'password',
    ];

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