Laravel自定义Agent登录逻辑报错：Authenticatable类型不匹配求助

报错原因及修复步骤 #

你遇到的报错核心原因是：Auth::login() 要求传入的对象必须实现 Illuminate\Contracts\Auth\Authenticatable 接口，而你的 Agent 模型既没实现该接口，同时用 DB::table() 查询返回的是普通对象（而非符合要求的模型实例），导致类型不匹配。

1. 修正Agent模型 #

修改 App\Models\Agent.php，让它继承Laravel提供的 Authenticatable 类（该类已内置实现 Authenticatable 接口）：

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;

class Agent extends Authenticatable
{
    // 指定表名（如果模型名复数和表名一致可省略，但显式声明更清晰）
    protected $table = 'agents';

    // 允许批量赋值的字段，按需添加其他字段
    protected $fillable = ['Email', 'password'];
}

2. 优化登录逻辑代码 #

不要用 DB::table() 查询，改用模型查询，同时移除不安全的明文密码比较逻辑：

public function login(Request $request)
{
    $request->validate([
        'Email' => 'required|email', // 增加邮箱格式验证，提升严谨性
        'password' => 'required'
    ]);

    // 用Agent模型查询记录
    $agent = \App\Models\Agent::where('Email', $request->Email)->first();

    // 先判断用户是否存在，再验证密码哈希
    if ($agent && Hash::check($request->password, $agent->password)) {
        Auth::login($agent);
        return redirect()->route('agent.index');
    }

    // 登录失败返回上一页并携带错误信息
    return back()->withErrors(['Email' => '邮箱或密码错误']);
}

额外学习途径（除官方文档外） #

• Laracasts视频教程：有专门的Laravel认证系列课程，从基础认证流程到自定义认证逻辑都有详细讲解，适合跟着实操。
• 阅读框架源码：重点看 Illuminate/Auth 目录下的文件（比如 SessionGuard.php、Authenticatable.php），能帮你理解认证的底层实现逻辑。
• 实战项目练习：动手做带认证功能的项目（比如后台管理系统、会员系统），在实践中掌握认证流程和中间件的使用。
• 社区交流：国内的Laravel社区有大量开发者分享的认证、中间件相关经验和问题解决方案，遇到问题可以搜帖或提问。

内容的提问来源于stack exchange，提问作者Ahmed Mahamed Abdallh