Workerman协程定时任务数据丢失源于异常未捕获、竞态未加锁及协程上下文销毁;需启用Swoole/Swow事件驱动、用try-catch包裹Timer::tick回调、单进程独占执行并以单调时钟校准触发精度。

Workerman协程定时任务在高并发或高频触发场景下出现数据丢失,本质是回调中未处理异常、未加锁导致竞态、或协程上下文被意外销毁所致。直接写Timer::tick却没捕获错误,一次未处理的PDOException就可能让后续所有tick静默终止。
确认协程驱动是否真正启用
Webman默认不开启协程,且未指定eventLoop时会回退至低精度Select驱动,其底层依赖usleep轮询,不仅精度不足(实际最小间隔约100ms),更致命的是——协程上下文无法稳定维持,yield后resume失败即丢弃当前协程栈,数据自然丢失。
第一步:检查config/process.php中目标进程配置,确认已显式设置eventLoop为Workerman\Events\Swoole::class或Workerman\Events\Swow::class;
第二步:在onWorkerStart中执行var_dump(Workerman\Events\EventInterface::class),输出必须是Workerman\Events\Swoole或Workerman\Events\Swow;
第三步:若输出为Workerman\Events\Select或Workerman\Events\Event,说明驱动未生效,立即停用Fiber驱动(因其调度漂移严重,不适用于生产级毫秒任务)。
改用协程原生Timer::tick并包裹try-catch
workerman/crontab组件基于字符串解析,内部仍以秒为单位触发,且无法处理毫秒粒度表达式;它不兼容协程上下文,回调中一旦抛出未捕获异常,整个协程即被销毁,后续tick永不触发——这就是数据丢失的根源。
方法一:在app/process/MicroTask.php的onWorkerStart中引入use Workerman\Coroutine\Timer;
方法二:用Timer::tick注册任务,必须在回调最外层加try-catch,且禁止任何同步I/O操作:
Timer::tick(300, function() { try { $data = Co\Http\Client::get('https://api.example.com/status'); // 协程HTTP请求 if ($data && isset($data['id'])) { Redis::set('last_task_id', $data['id']); } } catch (\Throwable $e) { \Workerman\Worker::log("Task failed: " . $e->getMessage()); // 记录到Worker日志,不抛出 } });
注意:绝对不要在协程定时器回调里调用file_put_contents、echo、var_dump等阻塞操作,它们会卡死当前协程,导致后续tick堆积或跳过。
确保单进程独占执行避免多实例覆盖
Worker默认启动多个子进程,每个进程都独立运行Timer::tick——若任务涉及写Redis计数器、更新数据库状态位,4个进程同时写同一key,最终值只反映最后一次写入,前面3次数据彻底丢失。
第一步:将该定时任务进程单独拆出,命名为app/process/SingleTask.php;
第二步:在该文件中设置$worker->count = 1;
第三步:在onWorkerStart中注册Timer::tick,无需任何进程ID判断——count=1即天然保证单例,避免分布式锁开销和误判风险。
用单调时钟校准防止累积漂移
单纯依赖Timer::tick(300)无法保证严格每300ms触发一次,事件循环负载升高时可能延迟500ms甚至更久;若任务需按固定时间点采样(如每秒整点上报),偏差累积会导致数据窗口错位、重复或遗漏。
在回调中使用Co::gettimeofday(true)获取微秒级时间戳,与基准时间比对:
$baseTime = 1723000000.0; // 设定一个起始秒戳(如2026-08-07 00:00:00)
Timer::tick(100, function() use ($baseTime) { $now = Co::gettimeofday(true); $nextSlot = $baseTime + round(($now - $baseTime) / 0.1) * 0.1 + 0.1; if ($now >= $nextSlot - 0.01) { // 容忍10ms误差内执行 reportData(); } });

















