使用Username替代Email时Laravel密码重置异常问题求助

你的问题核心在于Laravel密码重置系统默认依赖email作为用户标识字段，这个逻辑并非直接在PasswordBroker.php中实现，而是在TokenRepository（默认是Illuminate\Auth\Passwords\DatabaseTokenRepository）里。

问题根源 #

DatabaseTokenRepository的构造函数默认将email设为查询字段，其exists、create等操作数据库的方法，都会基于这个字段操作password_resets表，你看到的SQL错误正是这个类生成的。

解决步骤 #

1. 自定义TokenRepository

创建继承自DatabaseTokenRepository的子类，重写构造函数替换默认字段为username：

<?php

namespace App\Auth\Passwords;

use Illuminate\Auth\Passwords\DatabaseTokenRepository as BaseRepository;

class DatabaseTokenRepository extends BaseRepository
{
    /**
     * 创建自定义Token仓库实例
     */
    public function __construct($connection, $hasher, $table, $hashKey, $expires = 60)
    {
        parent::__construct($connection, $hasher, $table, $hashKey, $expires);
        // 将默认的email字段替换为username
        $this->emailField = 'username';
    }
}

2. 修改密码重置配置

在config/auth.php的passwords配置项中，为admins添加自定义仓库的指定：

'passwords' => [
    'users' => [
        'provider' => 'users',
        'table' => 'password_resets',
        'expire' => 60,
        'throttle' => 60,
    ],
    'admins' => [
        'provider' => 'admins',
        'table' => 'password_resets',
        'expire' => 60,
        'throttle' => 60,
        'repository' => App\Auth\Passwords\DatabaseTokenRepository::class, // 指定自定义仓库
    ],
],

3. 修改管理员模型

在你的管理员模型（比如App\Models\Admin）中，重写getEmailForPasswordReset方法，返回username：

<?php

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Contracts\Auth\CanResetPassword;

class Admin extends Authenticatable implements CanResetPassword
{
    // ... 其他模型代码

    /**
     * 返回用于密码重置的用户标识字段
     */
    public function getEmailForPasswordReset()
    {
        return $this->username;
    }
}

4. 手动生成Token的适配（如果你有相关逻辑）

如果是手动生成重置Token并写入数据库，确保使用username字段：

// 示例：手动生成并保存Token
$token = app('auth.password.broker')->createToken($admin);
DB::table('password_resets')->insert([
    'username' => $admin->username,
    'token' => app('hash')->make($token),
    'created_at' => now()
]);

验证 #

完成上述修改后，提交重置表单时，系统会自动使用username字段查询password_resets表，不再出现email字段不存在的错误。

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