ThinkPHP 6 高阶定时任务核心是 Redis 调度中枢：用 zset 实现真延迟队列（非轮询），任务类严格使用 fire(Job $job, $data) 签名，发布传字符串类名，消费端需分布式锁 + 手动 delete，Redis 连接须同步单例且禁用门面。
ThinkPHP 6 结合 Redis 实现高阶定时任务，核心不在“定时”本身，而在于精准触发、可靠执行与分布式协同。单纯靠 cron 调用命令行脚本已无法满足订单超时、消息重试、秒杀释放等场景的毫秒级响应和一致性要求。真正高阶的做法是：用 Redis 做调度中枢，用延迟队列替代轮询，用原子操作保障幂等，用任务生命周期管理杜绝堆积。
延迟队列必须用 Redis 有序集合（zset）
TP6 自带的 think-queue 默认不支持原生延迟，硬靠 delay() 是伪延迟（本质仍是轮询扫描）。高阶方案直接绕过框架封装，手写 zset 驱动：
- 将任务唯一标识（如
order_123456）作为 member，过期时间戳（time() + 30 * 60）作为 score 存入zadd order:delay:queue 1723000000 order_123456 - 消费进程每秒执行
zrangebyscore order:delay:queue -inf (1723000000获取待触发任务（注意开区间括号） - 成功处理后立即
zrem order:delay:queue order_123456，避免重复拉取
任务类必须严格遵循 fire() 签名
TP8.1.0 已统一规范，但 TP6 生态中大量旧代码仍误用 handle() 或 run()。高阶部署前务必检查：
- 任务类方法名只能是
fire(Job $job, $data)，多一个参数或少一个类型提示都会静默失败 - 发布时传字符串类名：
Queue::push('app\job\CancelOrderJob', $payload, 'order')—— 不传对象、不加@、不拼命名空间别名 - 队列名（如
'order'）会成为 Redis key 前缀：queues:order，监听命令必须显式指定：php think queue:listen --queue order
消费端必须内置分布式锁 + 手动 delete
多个 worker 实例同时监听同一队列时，极易重复消费。高阶防护不是靠 Redis 的单线程特性，而是主动加锁：
立即学习“PHP免费学习笔记（深入）”；
- 在
fire()开头用$redis->setNx('lock:cancel_order_'.$data['id'], time())尝试获取锁 - 紧接着
$redis->expire('lock:cancel_order_'.$data['id'], 60)设置有效期，防死锁 - 获取失败直接 return；获取成功才执行业务逻辑，完成后调用
$job->delete()—— 没这句，任务会被反复取出 - 若执行异常，建议用
$job->release(60)延迟 60 秒重试，而非直接fail()进入 failed_jobs 表
Redis 连接必须区分用途，禁用异步模式
在 Swoole + TP6 场景下，task 进程里 Redis 若启用异步客户端（如 predis 的 coroutine mode），会导致连接复用混乱甚至崩溃：
- 所有 task 任务中，只允许使用同步 Redis 客户端（如原生
\Redis类或 Predis 同步实例） - 推荐单例封装：全局唯一连接实例，每次请求复用同一 socket，避免频繁 connect/disconnect 开销
- 禁止在 task 中使用 TP6 门面（如
Cache::），因门面依赖容器自动加载，task 进程未初始化完整上下文会报错
