使用Redis缓存驱动时如何清除Laravel全部锁？

一、为什么php artisan cache:clear无法释放锁？ #

Laravel基于Redis实现的锁，键的格式为 {缓存前缀}:lock:{锁名称}，cache:clear失效通常有以下原因：

• 存储（store）不匹配：如果创建锁时指定了非默认的缓存存储（比如Cache::store('redis')->lock('myKey')），但cache:clear默认清理的是default配置对应的存储，锁所在的存储未被清理。
• Redis数据库分离：若缓存数据和锁数据配置在Redis的不同数据库（比如缓存用db 0，锁用db 1），cache:clear只会清空当前存储配置的数据库，锁所在的数据库不受影响。
• 未指定目标存储：执行命令时未明确指定Redis存储，需用php artisan cache:clear --store=redis来精准清理Redis存储的缓存。

二、批量释放所有锁的方法 #

方法1：自定义Artisan命令（推荐，安全高效） #

创建一个自定义命令来扫描并删除所有锁键，避免阻塞Redis：

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\Cache;

class ClearAllLocks extends Command
{
    protected $signature = 'cache:clear-locks {--store=redis : 缓存存储名称}';
    protected $description = '强制释放所有Laravel缓存锁';

    public function handle()
    {
        $store = Cache::store($this->option('store'));
        $redis = $store->getRedis();
        $prefix = $store->getPrefix();
        $lockPattern = "{$prefix}lock:*";

        // 使用SCAN命令分批处理，避免KEYS命令阻塞Redis
        $cursor = '0';
        do {
            [$cursor, $keys] = $redis->scan($cursor, ['match' => $lockPattern, 'count' => 100]);
            if (!empty($keys)) {
                $redis->del($keys);
                $this->info("已删除 ".count($keys)."个锁键");
            }
        } while ($cursor !== '0');

        $this->info('所有锁已成功释放');
    }
}

执行命令：

php artisan cache:clear-locks
# 若锁在指定存储，添加参数：
php artisan cache:clear-locks --store=redis

方法2：Redis命令行直接操作 #

登录Redis命令行，切换到锁所在的数据库（比如SELECT 1），执行以下脚本（数据量小时可用）：

# 替换your-cache-prefix为你的缓存前缀
EVAL "return redis.call('del', unpack(redis.call('keys', ARGV[1])))" 0 "your-cache-prefix:lock:*"

注意：大数据量下KEYS命令会阻塞Redis，优先用Artisan命令。

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