必须用原子性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，观察两个终端日志 —— 仅一个输出「? 锁已被占用，跳过本次执行」，另一个执行完整业务流程，说明分布式锁已起作用。
