Laravel7中如何根据邮箱清除指定用户的登录尝试记录

问题原因 #

Laravel的登录尝试限流逻辑由ThrottlesLogins trait实现，所有记录默认存储在缓存中，你当前的代码仅构造了Request实例，没有调用任何清除限流记录的方法，因此不会生效。

解决方案 #

1. 完善命令定义 #

首先确认你的自定义命令已经在$signature属性中声明了所需参数，示例如下：

protected $signature = 'auth:clear-attempts {user_email} {ip?}';
protected $description = 'Clear login attempts for specified user';

其中ip为可选参数，指定后仅清除对应IP下的登录尝试，不指定则清除该邮箱所有IP下的登录尝试。

2. 替换handle方法逻辑 #

use Illuminate\Support\Facades\RateLimiter;
use Illuminate\Support\Str;

public function handle()
{
    $email = Str::lower($this->argument('user_email'));
    $ip = $this->argument('ip');

    // 传入IP时清除指定IP的记录
    if ($ip) {
        $throttleKey = $email . '|' . $ip;
        RateLimiter::clear($throttleKey);
        $this->info("Login attempts for {$email} (IP: {$ip}) cleared.");
        return 0;
    }

    // 未传入IP时清除该邮箱所有记录（仅支持Redis缓存驱动）
    $cacheStore = \Cache::getStore();
    if (!method_exists($cacheStore, 'getRedis')) {
        $this->error('Non-Redis cache drivers require you to specify the IP parameter.');
        return 1;
    }

    $redis = $cacheStore->getRedis();
    $prefix = config('cache.prefix') . ':rate-limit:' . $email . '|*';
    $keys = $redis->keys($prefix);
    foreach ($keys as $key) {
        $redis->del($key);
    }

    $this->info("All login attempts for {$email} cleared.");
    return 0;
}

注意事项 #

• 上述代码适配Laravel 8及以上版本，Laravel 7及更低版本需替换RateLimiter门面的调用方式，改为从容器中获取Illuminate\Cache\RateLimiter实例后调用clear方法，限流key生成规则不变。
• 测试时可先故意输错密码锁定账号，运行命令php artisan auth:clear-attempts 你的邮箱 你的IP即可立即解除限制。
• Laravel 11+ 会自动注册App/Console/Commands下的命令，低版本需要手动在app/Console/Kernel.php的$commands数组中添加你的命令类。

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