Webman 中毫秒级定时任务必须使用 Workerman\Coroutine\Timer::tick(),因其支持原生毫秒精度且依赖 Swoole/Swow 驱动;需隔离进程、禁用同步 I/O、用协程客户端,并通过 Co::gettimeofday(true) 校准时间漂移。

Webman 里想跑毫秒级定时任务,光靠 workerman/crontab 组件不行——它最小只支持秒级,且所有任务共享事件循环,一卡全卡。
为什么 workerman/crontab 无法满足毫秒级需求
它本质是 cron 表达式解析器 + 秒级轮询触发器,内部用 Timer::add(1000, ...) 模拟每秒检查一次表达式匹配,根本没进入微秒调度层。你写 */500 * * * * *,它会直接忽略毫秒部分,当成 */1 * * * * * 处理。
- 所有任务注册在同一个 Worker 进程的 event loop 中,一个慢回调(比如
sleep(3)或未加超时的file_get_contents())会导致后续所有定时器延迟堆积 - 不感知协程上下文,
Co::sleep()、Co::mysql()等协程 I/O 在 crontab 回调里会退化为同步阻塞 - 日志时间戳显示“每 500ms 触发”,实际间隔可能飘到 800ms~2s,尤其在 CPU 负载高时
必须改用 Workerman\Coroutine\Timer 原生接口
这是唯一能真正抵达毫秒精度的路径,前提是底层驱动已切换为 Swoole 或 Swow。
- 确认驱动生效:
var_dump(Workerman\Events\EventInterface::class)输出必须是Workerman\Events\Swoole或Workerman\Events\Swow,不是Workerman\Events\Select - 在进程文件(如
app/process/MicroTask.php)的onWorkerStart中调用:Workerman\Coroutine\Timer::tick(200, fn() => do_something()) - 避免混用旧版
Workerman\Lib\Timer—— 它在协程环境下会被降级为 100ms 精度,且不兼容Co::sleep() - 单次延迟任务用
Timer::after(150.5, ...),注意传浮点数,整数会被截断为毫秒整数倍
必须隔离进程并禁用同步 I/O
毫秒级任务对事件循环极其敏感,任何阻塞都会导致调度失准。
立即学习“PHP免费学习笔记(深入)”;
- 在
config/process.php中为该任务单独配置一个进程,设置'count' => 1,禁止多实例抢占同一 event loop - 回调函数内严禁出现:
sleep()、usleep()、未设超时的curl_exec()、file_get_contents()、mysqli_query() - 必须用协程客户端:Redis 用
co\redis或Swoole\Coroutine\Redis,MySQL 用Swoole\Coroutine\MySQL,HTTP 用Co\Http\Client - 加
try-catch包裹回调体,防止未捕获异常中断整个 timer 循环
如何校准时间漂移?用 Co::gettimeofday(true)
系统时钟可能被 NTP 调整或存在 drift,单纯靠 Timer::tick() 的固定间隔会累积误差。
- 在每次回调开头记录当前单调时间:
$now = Co::gettimeofday(true); - 与上一次执行时间差值判断是否真正过了目标间隔,而非依赖调度器“应该”何时触发
- 例如每 200ms 执行但允许 ±10ms 漂移,可写:
if ($now - $last >= 0.19 && $now - $last - 不要用
microtime(true)替代 —— 它受系统时钟跳变影响,Co::gettimeofday(true)返回的是单调递增的微秒浮点数,更可靠
真正难的不是写那行 Timer::tick(100, ...),而是确保整个运行链路——驱动、进程模型、I/O 方式、时间源——全部对齐毫秒级语义。漏掉任意一环,表面看在跑,实际早已失准。



















