必须用原子性redis分布式锁解决tp6.0多实例定时任务并发问题:通过redislock类的setnx+expire原子操作加锁,key需含业务标识与时间维度,中间件方式更易复用,验证时仅一个节点执行成功。

TP6.0 多实例部署后,同一 Cron 定时任务在多个服务器上同时触发,导致数据库写入冲突、短信重复发送、扣费翻倍等生产事故,必须用原子性锁机制强制串行化执行。
确认定时任务已启用且多节点并行运行
进入项目根目录,执行 php think timer:status 查看当前定时任务状态;若返回中显示多个相同任务名(如 app\command\SyncOrder)处于 active 状态,说明多节点已同时加载该任务。
检查 config/timer.php 中是否已开启多进程支持:'multi_process' => true —— 若未开启,单机多进程也会模拟出并发效果,需一并排查。
引入 Redis 并配置连接参数
确保 config/cache.php 中已启用 redis 缓存驱动,并验证连接可用:php think cache:clear 后执行 php think test:redis(需自行添加一个简单 Redis 连通性测试命令)。
若使用哨兵或集群模式,必须将 cache.php 中的 'type' => 'redis' 改为 'type' => 'redis_cluster' 或对应类型,【否则 setnx 操作会因连接非单点而失败】。
封装 SetNX 分布式锁类
在 app/common/lock/RedisLock.php 中新建类:
第一步:定义构造函数接收 key、过期秒数、可选前缀
第二步:在 acquire() 方法中调用 $this->redis->set($this->key, $this->value, ['nx', 'ex' => $this->expire]) —— 注意必须使用 ['nx', 'ex' => ...] 数组参数形式,这是 ThinkPHP 6.0 Redis 驱动唯一支持的原子 setnx+expire 写法。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
第三步:若返回 true 表示加锁成功,立即返回;若返回 false 或 null,说明锁已被占用,直接终止后续逻辑。这一步不能用 get+set 组合替代,否则会破坏原子性。
在定时任务中注入并使用锁
方法一:在命令类 app/command/SyncOrder.php 的 handle() 开头插入:
$lock = new \app\common\lock\RedisLock('sync_order_lock', 300);
if (!$lock->acquire()) { $this->output->writeln('? 锁已被占用,跳过本次执行'); return; }
方法二:更健壮的做法是把锁逻辑抽成中间件,在 app/middleware/LockMiddleware.php 中实现 process(),然后在命令类的 $middleware 属性中声明启用 —— 这样无需修改每个任务的业务代码。
注意:锁的 key 必须带业务标识和时间维度,例如 'sync_order_' . date('YmdH'),避免跨小时任务被误阻塞。
验证锁是否生效
启动两个终端,分别在不同端口运行 php think timer:listen --port=8001 和 php think timer:listen --port=8002。
手动触发一次任务:php think timer:run app\command\SyncOrder,观察两个终端日志 —— 仅一个输出「? 锁已被占用,跳过本次执行」,另一个执行完整业务流程,说明分布式锁已起作用。










