使用缓存锁(如redis)是防artisan命令重复执行最直接有效的方式,推荐优先用cache::lock()自动管理,次选手动redis原子操作或withoutoverlapping中间件,极简环境可降级为数据库标记法。

用缓存锁(如 Redis)给 Artisan 命令加唯一标识锁,是最直接有效的防重复执行方式。
用 Cache::lock() 实现自动加锁与释放
在命令的 handle() 方法开头调用内置锁,键名必须包含业务上下文(比如命令名 + 关键参数哈希),避免所有同名命令共用一把锁:
- 例如:$lock = Cache::lock('backup:database:' . md5($this->option('connection')), 300);
- 调用 $lock->get() 尝试获取锁;返回 false 表示已被占用,此时可直接 $this->warn('命令正在运行中') 并 return;
- 闭包内执行备份逻辑,结束后锁自动释放,无需手动 del —— 即使异常中断也不会残留
手动 Redis SETNX 防锁失效场景
当需要更精细控制(如自定义过期策略、跨环境兼容性),可手动使用 Redis 原子操作:
- 生成带时间戳和随机串的锁键:$key = 'cmd:backup_' . Str::random(8) . '_' . now()->timestamp;
- 执行 Redis::set($key, 1, ['NX', 'EX' => 600]),成功返回 1 才继续执行
- 务必用 try-finally 包裹业务逻辑,确保 finally 中调用 Redis::del($key),防止死锁
结合队列任务时用 WithoutOverlapping
若该命令被封装为可调度的队列任务(如继承 ShouldQueue),推荐改用中间件锁:
- 在 dispatch 时指定唯一键:ProcessBackupJob::dispatch($connection)->onQueue('default')->middleware([new WithoutOverlapping('backup_' . md5($connection))]);
- 必须显式设置超时:->middleware([new WithoutOverlapping($key)->expiresAt(now()->addMinutes(10))])
- 确保 Redis 连接配置为共享实例(非 file 或 array 驱动),多台机器部署才真正生效
补充:数据库标记法作为兜底
对无法依赖 Redis 的极简环境,可用数据库临时记录状态(不推荐主方案,仅作降级):
- 建一张 command_locks 表,含 command_key(唯一索引)、started_at、pid 字段
- 执行前 INSERT IGNORE INTO command_locks (command_key, started_at, pid) VALUES (?, now(), ?)
- 检查影响行数是否为 1;不是则说明已存在,退出命令
- 执行结束或异常时 DELETE WHERE command_key = ? 清理记录











