罗罗编程学习记录
本页内容 展开查看

06.5.6.10 Timer 定时器与任务投递

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.6 Swoole

06.5.6.10-001 Swoole Timer 提供哪两类定时任务?

一句话结论

Timer 分重复定时(tick,按固定间隔反复触发)与单次延迟(after,延迟指定毫秒后只触发一次);两类定时器都挂在事件循环的定时器轮上,由循环到期回调执行。

概念解释

tick 用于周期任务:心跳保活、统计上报、空闲扫描、缓存刷新等;after 用于一次性延迟动作:超时兜底、延迟重试、会话过期检查。定时器依赖事件循环驱动,脱离循环后到期回调不会被执行。定时器按毫秒配置周期,实际触发时刻受调度与回调排队影响。

原理流程

  1. 代码中调用 Timer::tick 或 Timer::after,传入毫秒周期与回调。
  2. 运行时把定时器项加入事件循环定时器结构,记录到期时间。
  3. 事件循环轮询发现到期定时器,取出并执行回调。
  4. tick 重新登记下一次到期时间;after 执行后自动移除。

代码或图示

use Swoole\Timer;

Timer::tick(1000, function () {
    echo "tick: every 1000ms\n";
});

Timer::after(3000, function () {
    echo "after: once after 3000ms\n";
});

常见误区

  • 以为 after 也会重复触发:单次延迟执行完即移除,需要重复请用 tick。
  • 以为定时器在脚本结束后仍会跑:进程退出后定时器随事件循环销毁,未触发项丢失。

追问

  • 定时器周期支持小数毫秒吗?答:参数类型与精度边界以官方文档为准,待确认;常规按整数毫秒配置。
  • 两类定时器内部结构是否相同?答:都由事件循环定时器轮管理,注册与清除接口一致;内部实现细节以扩展源码为准。

06.5.6.10-002 tick、after、clear 的基本用法是怎样的?

一句话结论

tick/after 返回定时器 ID,clear($id) 按 ID 清除重复定时器;clearAll() 一类全量清理接口是否可用随版本不同,需核对官方文档,标注待确认。

概念解释

注册回调时可通过闭包捕获外部变量;清除定时器必须持有注册时返回的 ID。clear 只移除对应定时器项,不影响其他定时器。在回调内部清除自身定时器时,ID 需从闭包变量或回调参数获取,具体回调是否携带 ID 参数以版本为准。

原理流程

  1. 调用 Timer::tick($ms, $callback),运行时返回整型定时器 ID。
  2. 业务把 ID 存入可访问位置(数组、成员属性等)。
  3. 需要停止时调用 Timer::clear($id),从定时器轮移除该项。
  4. 重复 clear 或清理不存在的 ID,返回值形态需按版本核对。

代码或图示

use Swoole\Timer;

$timerId = Timer::tick(500, function () use ($timerId) {
    static $count = 0;
    $count++;
    if ($count >= 3) {
        Timer::clear($timerId); // 触发三次后停止
    }
});

常见误区

  • 在 tick 回调外找不到 ID 导致无法清除:注册时应保存返回值。
  • 把 after 的 ID 反复 clear:单次定时器执行后已移除,重复清理的行为以版本为准。

追问

  • 回调参数里能拿到定时器 ID 吗?答:部分版本回调签名携带 ID 参数;是否提供与参数顺序待确认,稳妥做法是闭包捕获返回 ID。
  • 全量清理接口叫什么?答:Timer::clearAll() 一类接口在不同版本命名与可用性有差异,使用前核对官方文档与 php --ri swoole。

06.5.6.10-003 如何获取与列出当前进程的定时器?

一句话结论

注册时通过返回值拿到单个定时器 ID;进程内定时器统计与列表可通过扩展提供的 stats/list 一类接口获取,具体方法名、返回字段随版本变化,使用前需核对官方文档,不确定处标注待确认。

概念解释

排查“定时器泄漏”“任务未停止”时需要观察进程内现存定时器数量与 ID 清单。统计接口通常返回定时器总数、延迟触发数一类字段;列表接口返回全部 ID。这些是进程内视角,不跨 Worker 汇总。接口不可用时,可在业务侧用注册表自行登记 ID 与元信息。

原理流程

  1. 调用扩展统计/列表接口读取当前进程定时器状态。
  2. 对比注册数、清除数与现存数量,判断是否有未清理项。
  3. 对异常 ID 回溯注册代码与清除路径。
  4. 扩展接口缺失或版本不匹配时,用业务注册表兜底统计。

代码或图示

use Swoole\Timer;

// 方法名与返回字段以本机版本官方文档为准;先核对再使用
$stats = Timer::stats(); // 待确认:返回字段名与结构
var_dump($stats);
// $ids = Timer::list(); // 待确认:列表接口可用性

常见误区

  • 把进程内定时器数量当成整机数量:每个 Worker/进程独立持有定时器,需分别观测。
  • 假设统计接口在所有版本同名同字段:版本差异需逐条核对,不能凭旧文档写生产代码。

追问

  • 业务侧怎么做定时器注册表?答:闭包/属性保存 ID、名称、注册时间与周期;清除时同步注销,定期比对注册表与实际在跑项。
  • 定时器 ID 会复用吗?答:ID 编号策略以扩展实现为准;不要把 ID 持久化为业务身份标识。

06.5.6.10-004 定时器回调运行在什么上下文,与协程是什么关系?

一句话结论

定时器回调由事件循环到期触发;在协程化运行时中,回调内是否自动拉起协程、能否直接调用协程客户端,取决于版本配置与接口行为,需按官方文档核对,标注待确认。

概念解释

事件循环回调先在循环线程/进程上下文执行。早期版本回调运行在非协程上下文;部分版本或配置下定时器回调可自动进入协程环境。判断依据:回调内调用 Coroutine::getCid() 的返回值、调用协程客户端是否挂起正常。不确定时在回调内显式 go() 包裹需要协程化 IO 的逻辑,避免阻塞事件循环。

原理流程

  1. 事件循环检测到定时器到期,调度回调执行。
  2. 运行时按版本规则决定回调上下文(主协程/非协程)。
  3. 回调内若执行阻塞 IO,按上下文是否 hook 决定是否挂起让出。
  4. 回调返回后事件循环继续处理其他事件。

代码或图示

use Swoole\Timer;
use Swoole\Coroutine;

Timer::after(100, function () {
    $cid = Coroutine::getCid(); // 返回值用于判断当前上下文,约定以版本为准
    go(function () {
        // 显式协程化:协程客户端与挂起 IO 在此上下文内执行
        echo "inner coroutine running\n";
    });
});

常见误区

  • 假设定时器回调天然在协程内:版本行为有差异,跨版本迁移需回归验证。
  • 在回调里直接跑未 hook 的阻塞调用:会卡住事件循环,连带其他定时器与连接事件延迟。

追问

  • 如何确认回调是否在协程内?答:回调内打印 Coroutine::getCid() 与错误日志上下文;在测试环境复现后记录本机版本结论。
  • 回调里能启动新定时器吗?答:可以在回调内注册新的 Timer 项;嵌套注册的生命周期与清除路径要一并管理。

06.5.6.10-005 定时器精度是毫秒级吗,为什么会产生漂移?

一句话结论

定时器以毫秒为配置单位,但实际触发时刻不等于精确毫秒:事件循环轮询间隔、回调排队、协程调度与系统负载都会造成延迟,长周期 tick 还会累积漂移。

概念解释

定时器到期由事件循环在每轮轮询中检查,若上一轮回调尚未返回、事件队列积压,到期定时器只能延后执行。tick 按间隔重新登记下次触发,若本次回调被延迟,后续触发时刻也可能顺移;对时间敏感的任务不能把 Timer 当成定时中断。高频小间隔定时器还会增加循环调度开销。

原理流程

  1. 定时器项记录计划到期时间。
  2. 事件循环每轮检查到期项,发现后加入执行队列。
  3. 回调排队等待当前执行权,实际开始时间晚于计划时间。
  4. tick 以本次触发为基准登记下一轮,延迟沿周期向后累积。

代码或图示

计划触发时刻: T0, T0+Δ, T0+2Δ
实际触发时刻: T0+e1, T0+Δ+e2, T0+2Δ+e3
ei:轮询间隔、回调排队、调度与负载造成的延迟
漂移示例:回调阻塞时 ei 增大,周期任务整体后移

常见误区

  • 把毫秒参数当成硬性精度保证:生产定时任务需容忍调度延迟,重要时刻校验当前时间。
  • 用极短间隔 tick 跑密集任务:高频回调加重事件循环负担,反而放大延迟。

追问

  • 对时间敏感的任务怎么补偿?答:回调内读取当前时间核对是否到达业务时刻,错过阈值则跳过或记录;不要依赖定时器自身精度。
  • 漂移可以配置消除吗?答:运行时调度策略无法保证无漂移;只能通过缩短回调耗时、降低循环负载来减小误差。

06.5.6.10-006 定时器回调阻塞会带来什么后果?

一句话结论

回调内出现未让出的阻塞调用或长 CPU 计算,会卡住事件循环,导致同进程其他定时器延迟、网络连接事件堆积、协程无法被调度恢复。

概念解释

事件循环单轮执行顺序中,定时器回调与网络回调共享同一执行权。回调阻塞期间,循环无法处理新就绪事件:其他到期定时器排队、连接读写事件积压、挂起协程收不到唤醒。表现为接口延迟整体抬升、心跳超时、定时任务忽快忽慢。重任务应拆出到 Task Worker 或独立进程,回调内只做轻量触发与投递。

原理流程

  1. 定时器到期进入回调执行。
  2. 回调内出现阻塞 IO 或长循环,不产生挂起点。
  3. 事件循环被占住,其他就绪事件排队等待。
  4. 回调结束后积压事件集中处理,期间表现为大面积延迟。

代码或图示

use Swoole\Timer;

// 反例示意:回调内纯 CPU 长循环,独占事件循环
Timer::tick(1000, function () {
    $sum = 0;
    for ($i = 0; $i < 100000000; $i++) {
        $sum += $i; // 无挂起点,阻塞当前循环
    }
});

常见误区

  • 以为定时器在独立线程跑:默认与服务事件循环同进程调度,阻塞会互相影响。
  • 回调内做远程调用却不确认协程化:未 hook 的阻塞调用直接卡住循环。

追问

  • 重任务放在哪执行?答:投递到 Task Worker 或自定义进程;定时器回调只负责生成任务与投递,具体投递接口见本章节任务投递部分。
  • 如何发现回调阻塞?答:观测定时器触发间隔抖动、循环内事件堆积与接口延迟分位值;记录回调起止耗时定位长回调。

06.5.6.10-007 进程退出时未触发的 after 定时器会怎样?

一句话结论

进程退出意味着事件循环销毁,尚未到期的 after 定时器不会再执行,也不会持久化到磁盘;需要持久化延迟任务必须落到外部队列或存储。

概念解释

Timer 是进程内内存态调度:定时器项、回调闭包都在进程内存中。服务 reload、进程被 kill、机器重启时,未到期的单次任务一并丢失。补偿类、重试类延迟任务不能只靠 after,应写入数据库/消息队列,由独立调度器到期取出执行。tick 同理:重启后需重新注册。

原理流程

  1. 进程进入关闭流程,事件循环停止分发事件。
  2. 内存中未到期定时器项随进程销毁。
  3. 新进程启动后按初始化逻辑重新注册所需定时器。
  4. 持久化延迟任务由外部存储在恢复后扫描补偿。

代码或图示

after 定时器(内存态):进程退出即丢失,不持久化
持久化延迟任务:写入外部队列/存储 → 调度器到期扫描 → 执行与状态回写

常见误区

  • 用 after 承载“30 分钟后必须重试”的业务任务:进程重启后任务消失。
  • 重启后以为旧定时器自动恢复:定时器需在启动回调中显式重新注册。

追问

  • 重启后如何恢复周期任务?答:在 onWorkerStart 一类启动回调中按配置注册 tick;注意多 Worker 下重复注册问题见后续题目。
  • 延迟重试怎么落地?答:任务表记录下次执行时间,由调度进程/定时扫描取出;状态机记录待执行/执行中/完成,配合幂等键。

06.5.6.10-008 定时器回调抛出异常如何处理?

一句话结论

回调内未捕获异常会终止当前回调执行,异常信息进入错误日志/错误处理路径;不影响事件循环中其他定时器继续运行,但业务状态可能停留在半完成状态。

概念解释

与协程回调类似,定时器回调是独立执行单元,异常不会向上冒泡到注册代码。未捕获异常导致本次回调中断:已执行部分写入、未执行部分跳过。回调内必须按业务边界包 try/catch,记录错误上下文,必要时触发补偿。致命错误(Fatal)对进程的影响需按版本与错误类型核对,避免线上进程异常退出。

原理流程

  1. 回调执行中抛出异常,当前调用帧未捕获。
  2. 运行时终止本次回调,记录错误信息。
  3. 事件循环继续处理其他到期定时器与网络事件。
  4. 业务根据错误日志决定重试、补偿或告警。

代码或图示

use Swoole\Timer;

Timer::tick(1000, function () {
    try {
        // 业务逻辑:可能抛出异常
        throw new RuntimeException('timer task fail');
    } catch (\Throwable $e) {
        echo sprintf("timer error: %s\n", $e->getMessage());
    }
});

常见误区

  • 依赖外层 try/catch 捕获定时器内异常:注册点与回调执行点不在同一调用链。
  • 异常后不记录任务标识:排查时无法定位是哪一轮、哪个业务实例失败。

追问

  • 异常如何集中上报?答:回调入口统一捕获后写结构化日志/指标;扩展错误回调接口名称与参数以官方文档为准,待确认。
  • 连续失败要不要自动停掉定时器?答:可按失败计数熔断,避免故障期反复刷错误;恢复策略与告警阈值在业务侧设计。

06.5.6.10-009 长周期定时任务与 Worker 重启有什么关系?

一句话结论

定时器随 Worker 进程存活,max_request 重启、reload 或异常退出都会销毁进程内定时器;新 Worker 启动后需重新注册,且长任务执行期间 Worker 不应被强制中断。

概念解释

Worker 按 max_request 处理一定请求后退出重建,定时器在旧进程销毁、新进程重建。注册位置通常选在 Worker 启动回调内,保证每个新 Worker 都重新挂定时项。正在执行的长任务遇到 Worker 退出需要收尾策略:任务可中断的等待退出,不可中断的需在任务队列中持久化状态,重启后继续。

原理流程

  1. Worker 启动,在启动回调中注册周期/单次定时器。
  2. 服务运行期间定时器由本进程事件循环驱动。
  3. 达到 max_request 或收到 reload 信号,Worker 进入收尾退出。
  4. 新 Worker 拉起后再次执行注册逻辑,恢复定时任务。

代码或图示

// 示意:在 Worker 启动回调中注册定时器,随进程重建恢复
$server->on('WorkerStart', function ($server, $workerId) {
    // 按业务规则判断是否在该 Worker 注册(多 Worker 去重见后续题目)
    \Swoole\Timer::tick(5000, function () {
        echo "periodic task in worker {$workerId}\n";
    });
});

常见误区

  • 在脚本顶层注册定时器:Worker 重建后新进程没有执行顶层代码,定时器丢失。
  • 长任务执行中进程被重启:任务中途状态未保存,出现半截写入。

追问

  • 如何避免重启打断长任务?答:任务状态持久化到队列/存储,Worker 退出前等待在跑任务收尾;重启窗口与任务调度错开。
  • max_request 与定时器冲突怎么调?答:定时器常驻进程不受请求计数影响;若 Worker 频繁重启导致任务不稳,评估调整 max_request 或把周期任务移到独立进程。

06.5.6.10-010 Timer 定时任务与 Server 的 task 投递有何区别?

一句话结论

Timer 解决“什么时候触发”(时间维度调度),task 投递解决“把重任务交给谁执行”(执行资源维度);两者常配合:定时器到期触发,回调内把任务投递给 Task Worker 异步处理。

概念解释

Timer 回调与服务事件循环同进程,适合轻量、短耗时动作;task 投递把数据打包交给独立的 Task Worker 进程池消费,Web Worker 不被重任务阻塞。Timer 是内存态时间调度,task 队列也是进程内内存队列(持久化能力有限)。框架层常把两者封装为异步任务组件,扩展层只提供原生投递通道。

原理流程

  1. 定时器到期触发回调(时间触发)。
  2. 回调内判断业务条件,打包任务数据调用投递接口。
  3. Server 把任务放入任务队列,分发给 Task Worker 消费。
  4. Task Worker 执行完成后按回传路径通知主 Worker。

代码或图示

Timer(时间调度):到期 → 轻量回调 → 投递任务
        ↓
task 投递(执行资源):任务队列 → Task Worker 池 → 结果回传
        ↓
持久化需求:外部队列/存储补充内存队列的可靠性

常见误区

  • 把重计算直接写进 Timer 回调:阻塞事件循环,应投递出去。
  • 认为 task 队列持久化:内存队列在进程重启后丢失,可靠性任务需外部存储。

追问

  • 哪些任务适合直接 Timer 回调内做?答:状态检查、计数上报、轻量缓存刷新;耗时 IO、批量处理、重计算走 Task Worker。
  • Task Worker 职责概述见哪里?答:进程模型章节已说明 Master/Manager/Worker/Task Worker 分工,本题聚焦投递与回调链路。

06.5.6.10-011 task() 投递任务的参数与回调链路是怎样的?

一句话结论

通过 Server 实例的 task() 方法把任务数据投递到任务队列,指定目标 Worker 或回调标识;任务在 onTask 回调中被消费,执行结果再经 onFinish 一类回传回调回到主 Worker。具体参数顺序与方法名以版本文档为准,标注待确认。

概念解释

投递数据会序列化后进入队列,因此任务参数应是可序列化的标量/数组,不能携带资源句柄、连接对象或闭包。onTask 在 Task Worker 上下文执行,返回值作为任务结果;onFinish(或对应回传回调)在主 Worker 处理结果。部分版本提供协程化投递等待接口(如 taskCo/task_wait 一类),可用性与签名待确认。

原理流程

  1. 主 Worker 调用投递接口,传入任务数据、目标 Worker 标识与回调标识。
  2. Server 把任务放入进程内任务队列。
  3. 空闲 Task Worker 从队列取出任务,触发 onTask 回调执行。
  4. onTask 返回结果,Server 触发回传回调,主 Worker 处理收尾。

代码或图示

$server->on('WorkerStart', function ($server) {
    $server->task(['type' => 'report', 'date' => '2026-11-19']);
});

$server->on('Task', function ($server, $taskId, $srcWorkerId, $data) {
    echo sprintf("task %d in worker %d\n", $taskId, $srcWorkerId);
    return ['status' => 'done']; // 结果进入回传回调
});

$server->on('Finish', function ($server, $taskId, $result) {
    echo sprintf("finish %d: %s\n", $taskId, json_encode($result));
});

常见误区

  • 投递闭包/连接对象:不可序列化,跨进程传递失败或对象状态丢失。
  • 以为投递是同步等待结果:默认投递后立即返回,结果走异步回传回调;等待式接口需单独核对版本支持。

追问

  • 任务数据支持哪些类型?答:可序列化的数组、标量;资源、句柄、匿名函数不可跨进程传递,具体序列化限制以扩展实现为准。
  • 投递时能否指定 Task Worker?答:参数中可指定目标 Worker 编号,默认由队列分配;参数名与默认规则待确认。

06.5.6.10-012 Task Worker 并发消费与队列积压如何表现?

一句话结论

Task Worker 数量决定并发消费度,任务生产快于消费时队列积压;积压表现为任务等待时间拉长、回传延迟,严重时投递侧队列满或进程内存增长。

概念解释

任务队列在内存中排队,task_worker_num 配置并发消费 Worker 数。单任务耗时长或 Worker 数不足时,队列长度持续增长。投递侧与消费侧形成生产者-消费者模型:消费能力 = Task Worker 数 × 单 Worker 单位时间处理量。积压排查要看队列长度趋势、单任务耗时分布与 Task Worker CPU/内存状态。

原理流程

  1. 主 Worker 持续投递任务,进入任务队列。
  2. Task Worker 逐个取出执行,处理完回到队列取下一条。
  3. 生产速率大于消费速率时,队列长度单调上升。
  4. 任务排队时间增加,回传 Finish 延迟;队列接近上限后投递行为按策略处理。

代码或图示

生产速率 P(任务/秒)
消费速率 C = Task Worker 数 × 单 Worker 处理速率
P > C:队列积压,等待时间增长
P ≤ C:队列稳定,等待时间受控
观测:队列长度趋势 / 单任务耗时 / Worker 利用率

常见误区

  • 任务慢只加主 Worker 数:瓶颈在 Task Worker 池,加 Web Worker 不提升消费能力。
  • 忽略单任务耗时分位值:平均耗时正常不代表长尾任务没有积压。

追问

  • 队列长度从哪里观测?答:扩展提供的状态接口或业务计数;具体接口名与字段以官方文档为准,待确认。
  • 积压到什么程度需要告警?答:队列长度持续增长、任务等待时间超过业务容忍阈值;阈值按压测基线与任务时效要求设定。

06.5.6.10-013 投递失败(队列满、Worker 不存在)如何感知?

一句话结论

投递接口返回失败标识或抛出/返回错误,需在投递侧显式检查返回值;队列满、未配置 Task Worker、任务数据不可序列化都可能导致投递失败,失败后要有补偿与告警路径。

概念解释

投递不是“丢进队列就成功”:队列容量、Worker 配置、数据序列化任一环节不满足都会失败。返回值形态(false、错误码、异常)随版本不同,需在本机版本核对。常见失败场景:未配置 task_worker_num、任务数据含不可序列化内容、队列已满且拒绝新任务。失败任务应进入重试或落库补偿,不能静默丢弃。

原理流程

  1. 调用投递接口,传入任务数据与参数。
  2. 扩展校验 Worker 配置、序列化数据、队列容量。
  3. 校验通过:任务入队;校验失败:返回失败标识/错误信息。
  4. 投递侧检查返回,失败任务按重试/落库/告警策略处置。

代码或图示

go(function () use ($server) {
    $result = $server->task(['type' => 'cleanup']);
    // 返回值形态以版本为准:false / task id / 错误标识,需核对文档
    if ($result === false) {
        echo "task dispatch failed, persist for retry\n";
    }
});

常见误区

  • 投递后不检查返回值:失败任务静默丢失,线上表现为任务“偶发不执行”。
  • 队列满时无限重试投递:会加剧积压,应退避或落库异步补偿。

追问

  • 队列容量由什么配置?答:任务队列长度相关配置项名称与默认值以官方文档为准,待确认;需结合压测峰值设定。
  • 不可序列化内容怎么排查?答:投递前检查数据类型,日志记录任务标识;跨进程传输只保留标量与数组。

06.5.6.10-014 任务结果如何通过 Finish 回传主 Worker?

一句话结论

onTask 返回值作为任务结果,Server 在 Task Worker 执行完成后触发回传回调(onFinish 一类),把结果送回投递任务的主 Worker;回传同样走进程间通信,结果需可序列化。

概念解释

回传链路与投递方向相反:Task Worker → Server → 主 Worker。回传数据同样受序列化约束,不能携带连接、闭包。主 Worker 在回传回调中做收尾:更新业务状态、释放资源、记录指标。若任务执行失败,onTask 可返回错误标识,由回传回调统一判断,而不是让异常跨进程传播。

原理流程

  1. onTask 执行完成,返回结果数组或错误标识。
  2. Server 序列化结果,经进程间通信提交给对应主 Worker。
  3. 主 Worker 触发回传回调,携带任务 ID、来源 Worker 与结果。
  4. 回调内按结果状态更新业务,记录任务终态。

代码或图示

$server->on('Task', function ($server, $taskId, $srcWorkerId, $data) {
    try {
        return ['ok' => true, 'data' => 'processed'];
    } catch (\Throwable $e) {
        return ['ok' => false, 'error' => $e->getMessage()];
    }
});

$server->on('Finish', function ($server, $taskId, $result) {
    $result = json_decode(is_string($result) ? $result : json_encode($result), true);
    echo sprintf("task %d finish, ok=%s\n", $taskId, var_export($result['ok'] ?? false, true));
});

常见误区

  • 在 onTask 内直接操作主 Worker 上下文对象:两进程地址空间隔离,对象不共享。
  • 回传大结果集:进程间通信与序列化成本高,结果只回传状态与必要标识。

追问

  • 任务没触发 Finish 正常吗?答:onTask 未返回、进程异常退出或回传失败都会导致缺 Finish;需结合任务终态日志排查。
  • 回传回调运行在哪个进程?答:主 Worker 上下文;具体调度位置以版本实现为准。

06.5.6.10-015 任务队列是内存队列还是持久化队列?

一句话结论

扩展原生任务队列是进程内内存队列,重启、崩溃、reload 后未消费任务丢失;需要可靠投递与可追溯任务必须引入外部队列或存储做持久化补偿。

概念解释

内存队列好处是无额外中间件依赖、投递路径短;局限是不可持久化、跨进程不共享、容量受限。业务把任务可靠性分级:日志刷新、计数上报等可丢弃任务走原生队列;下单补偿、消息重试、数据对账等可靠任务落外部队列/数据库,配合任务状态机与幂等键。

原理流程

  1. 判断任务时效与可靠性要求。
  2. 可丢失任务:直接原生 task 投递。
  3. 可靠任务:先写持久化存储,再投递触发;消费者执行成功回写状态。
  4. 进程重启后由扫描流程补偿未完成任务。

代码或图示

原生内存队列:低延迟、无中间件、重启丢失
持久化方案:任务表 / 外部队列
  状态:待执行 → 执行中 → 完成 / 失败重试
  补偿:扫描超时执行中与待执行任务,按重试策略重投

常见误区

  • 把财务、补偿类任务放进原生队列:进程重启即丢失,风险不可接受。
  • 持久化后不做状态回写:重启补偿无法区分已完成与遗留任务。

追问

  • 内存队列容量满了怎么办?答:按投递失败路径落库补偿;评估任务量与队列配置,避免长时间积压。
  • 外部队列选型属于本章节范围吗?答:消息队列与分布式事务在对应专题展开;本章节只标注内存队列边界与持久化必要性。

06.5.6.10-016 定时任务如何保证幂等,避免重复执行造成副作用?

一句话结论

定时任务设计为幂等:同一任务重复执行不产生额外副作用,通过业务唯一键、状态机、去重表或条件更新保证;触发重复(多 Worker、重试、补偿)时结果保持一致。

概念解释

重复触发来源很多:多 Worker 各注册一次、定时补偿与正常任务重叠、任务失败后重试、手动补跑。幂等手段:以业务键记录执行状态,先查状态再执行;写操作使用条件更新(只更新未处理记录);去重表唯一约束拦截重复;外部副作用(发消息、扣款)带幂等键。任务执行记录需可追溯。

原理流程

  1. 任务入口按业务键查询执行状态。
  2. 已完成/执行中:跳过或返回已有结果。
  3. 未执行:登记执行中状态,执行业务后回写完成。
  4. 失败重试:状态回退待执行,按重试次数与间隔重试。

代码或图示

幂等判定:业务唯一键 + 状态机
未执行 → 抢占登记执行中 → 执行 → 完成
执行中 / 已完成 → 直接跳过
条件更新示例:UPDATE tasks SET status='done' WHERE id=? AND status='running'
重复触发时影响行数为 0,说明已被其他执行方处理

常见误区

  • 任务副作用天然幂等:扣款、发券、推送等写操作必须显式设计幂等键与去重。
  • 只靠定时器不重复:补偿、重试、多进程都会造成重复触发。

追问

  • 分布式锁能替代幂等吗?答:锁解决并发抢占,幂等解决重复执行结果;两者配合,锁过期或重试后仍需幂等兜底。
  • 外部系统调用怎么幂等?答:请求带业务幂等键,下游记录键与结果;重复请求返回首次结果,具体支持以下游接口为准。

06.5.6.10-017 上一轮任务未跑完,下一轮定时触发重叠怎么办?

一句话结论

周期任务需防重入:上一轮未结束时跳过本轮或排队等待;常用做法是执行标志位/锁控制,避免任务叠加把连接、下游与内存压垮。

概念解释

tx 间隔小于任务耗时时,多轮任务会重叠执行:同一业务被并发处理,数据库更新冲突、下游被重复调用。防重入方式:进程内用静态/Atomic 标志位标记执行中;跨进程用锁或任务表抢占状态。跳过策略:本轮检测到执行中直接返回;排队策略:等待上一轮结束再执行,但要控制等待超时。

原理流程

  1. 定时器到期触发任务回调。
  2. 检查执行标志/锁:已在执行则按策略跳过或等待。
  3. 未在执行:抢占标志,执行任务。
  4. 任务结束释放标志;异常路径也要释放,避免标志永久占用。

代码或图示

use Swoole\Atomic;

$running = new Atomic(0); // 进程内防重入标志;跨进程需锁/存储
Timer::tick(1000, function () use ($running) {
    if (!$running->cmpset(0, 1)) {
        echo "previous round still running, skip\n";
        return;
    }
    try {
        // 执行本轮任务
    } finally {
        $running->set(0);
    }
});

常见误区

  • 任务变慢后不防重入:轮次叠加,故障被放大成并发雪崩。
  • 异常路径漏释放标志:后续所有轮次被跳过,任务“静默停摆”。

追问

  • 跨进程防重入用什么?答:分布式锁或任务表状态抢占;进程内 Atomic 只保护本进程,跨 Worker 不共享。
  • 跳过与等待怎么选?答:实时性要求低、允许滞后选跳过;结果必须逐轮产出选排队等待,并设等待超时。

06.5.6.10-018 多 Worker 下定时任务如何避免各进程重复执行?

一句话结论

多进程模型中每个 Worker 都可能注册定时器,周期任务必须选定单一执行方:指定 Worker 编号、独立自定义进程调度,或借助分布式锁/外部协调器选主,避免同一任务在多进程重复跑。

概念解释

Server 模式下 Worker 数大于 1,在 WorkerStart 注册的定时器会在每个 Worker 各挂一份。解决方式按部署形态选择:只在指定编号 Worker 注册;单独起一个自定义进程跑调度;多进程竞争分布式锁,拿到锁的进程执行。计数上报类任务可允许各进程分片统计后汇总,业务写操作必须单执行方。

原理流程

  1. 识别任务类型:可分片聚合还是必须单实例执行。
  2. 单实例任务:按 Worker 编号筛选、独立进程或选主锁确定执行方。
  3. 执行方在任务内完成幂等校验,防止选主切换间隙重复。
  4. 其他 Worker 跳过该任务,只保留自身分片职责。

代码或图示

$server->on('WorkerStart', function ($server, $workerId) {
    // 示意:只在编号为 0 的 Worker 注册周期任务;编号规则以部署配置为准
    if ($workerId === 0) {
        \Swoole\Timer::tick(5000, function () {
            echo "single-instance periodic task\n";
        });
    }
});

常见误区

  • 所有 Worker 都注册同一写任务:重复执行导致重复扣款、重复发消息。
  • 指定 Worker 编号后不考虑 Worker 重启:编号对应进程重建后注册逻辑仍需生效。

追问

  • 选主锁过期导致双主怎么办?答:任务内幂等兜底,锁租约与心跳监控;双主执行时幂等保证结果一致。
  • 独立调度进程与 Worker 内注册怎么选?答:任务重或可靠性要求高走独立进程;轻量检查可挂指定 Worker,避免额外进程。

06.5.6.10-019 定时任务执行频率与资源消耗如何权衡?

一句话结论

周期间隔按业务时效要求与资源预算设定:频率越高,定时器回调、扫描与下游调用开销越大;应结合任务耗时、下游承载能力与进程负载压测回调取值。

概念解释

高频定时器带来三重成本:事件循环调度次数、回调内业务处理、对下游存储/接口的访问量。例如每秒扫描一次数据库表与每分钟扫描一次,数据库压力相差数十倍。设计时先确定业务可接受的延迟上限,反推最短周期;再用压测观察回调耗时、CPU 与下游负载,避免周期短于任务完成所需时间造成重入。

原理流程

  1. 明确任务时效要求:数据延迟可接受多久。
  2. 反推候选周期区间,统计单次任务平均与长尾耗时。
  3. 压测不同周期下的 CPU、内存、下游指标与任务排队情况。
  4. 选取满足时效且资源留有余量的周期,上线后按监控回调。

代码或图示

周期决策顺序:
业务时效上限 → 最短可行周期 → 单次任务耗时与资源占用
  → 压测对比 CPU / 下游负载 / 任务积压 → 取保守周期
注意:周期 < 单次耗时时,任务必然重入或排队

常见误区

  • 周期设得比业务需要更短:增加负载却不提升体验。
  • 只看单次任务耗时不看下游客户量:扫描任务放大后打爆数据库/缓存。

追问

  • 大批量扫描任务怎么降频不降效?答:分批分页处理、增量标记代替全表扫描;把单次重任务拆成多个小批轮询。
  • 周期任务需要动态调整吗?答:可按流量时段调整周期;动态配置变更需经配置中心或重启流程,不在任务内随机改周期。

06.5.6.10-020 定时器与任务相关线上问题如何排查?

一句话结论

按“是否触发、是否消费、是否回传、是否重复”四段链路排查:先看定时器注册与触发记录,再看任务队列积压与 Task Worker 状态,最后核对回传结果与幂等去重记录。

概念解释

典型问题分类:定时器未触发(未注册、进程退出、回调阻塞);任务未消费(队列积压、Task Worker 不足、投递失败);结果未回传(执行异常、回传丢失);重复执行(多 Worker 未去重、重试叠加)。排查沿链路分段定位:日志记录任务标识、触发进程、入队时间、开始执行时间、完成时间与结果状态。

原理流程

  1. 确认定时器是否注册:进程启动回调日志、现存定时器统计。
  2. 确认任务是否入队:投递返回值、队列长度与任务标识记录。
  3. 确认是否被消费:Task Worker 开始/结束日志、耗时分布。
  4. 确认结果与重复:Finish 回传记录、幂等表/去重记录对照。

代码或图示

排查链路:
未触发 → 注册位置 / 进程存活 / 回调阻塞 / 上下文异常
未消费 → 队列积压 / Worker 数 / 投递失败返回 / 数据序列化
未回传 → onTask 异常 / 进程退出 / 回传通信失败
重复跑 → 多 Worker 去重 / 重试叠加 / 锁与幂等记录

常见误区

  • 只查主 Worker 日志:Task Worker 与回传回调在不同进程,需按任务 ID 串联各进程记录。
  • 不记录时间戳:无法区分是排队慢、执行慢还是回传慢。

追问

  • 线上如何快速复现定时任务问题?答:测试环境用短周期复现,打印各环节时间戳;可靠任务在持久化表中留全链路状态。
  • 哪些问题需要升级扩展版本核对?答:回调上下文、统计接口、等待式投递等版本相关行为;记录本机版本号后对照官方文档,不确定处标注待确认。