Hyperf定时任务无内置单次最大时长限制，但受协程超时（推荐Co::set或手动埋点）、Swoole Timer阻塞风险、进程级兜底（如Consumer+ini_set）及运维层systemd/supervisord超时管理四重约束。
Hyperf 定时任务本身没有内置的“单次执行最大时长”硬性限制，但实际运行时长受多个层级约束，需从协程超时、Swoole Timer 机制、进程资源和业务兜底四方面协同控制。
协程执行超时（最常用且推荐）
Hyperf 的 @Crontab 任务在协程中执行，可通过 Co::set(['max_exec_time' => 秒数]) 或更稳妥的方式——在任务逻辑内主动加超时控制：
- 使用
Co::create(function () { /* 你的任务逻辑 */ });+Co::sleep()不适用，应改用带超时的协程客户端（如Hyperf\HttpClient配置timeout） - 对耗时操作封装
Co::wait()或Channel::pop($timeout)实现可中断等待 - 关键路径建议手动埋点：任务开始记录时间戳，循环中判断是否超时并提前 return
Swoole Timer 生命周期与信号安全
Hyperf 的 Crontab 调度底层依赖 Swoole 的 swoole_timer_tick。该定时器本身不设单次回调超时，但若某次 execute() 执行过久：
- 会阻塞同一线程内其他 Timer 回调（包括健康检查、心跳等），影响系统稳定性
- 若超过
max_wait_time（Swoole 全局配置，默认 60s），可能触发 worker 协程调度异常 - 不建议依赖
pcntl_alarm等信号方式强制中断，协程环境下易导致状态不一致或崩溃
进程级兜底：通过自定义 Consumer 进程控制
若任务逻辑极重（如批量报表生成），推荐将其移出 Crontab，改用异步队列 + 自定义 Consumer 进程，并在进程启动时设置：
-
ini_set('max_execution_time', 300);（PHP 层面软限制，协程中效果有限） - 在
handle()中监听ServerManager::isRunning()并配合时间戳做主动退出 - 结合
concurrent.limit控制并发数，避免单个慢任务拖垮整组消费者
运维层防护：systemd 或 supervisord 超时管理
对于以独立进程方式运行的定时任务（如通过 php bin/hyperf.php task:xxx 启动的命令），可在进程管理器中设硬性限制：
- systemd unit 文件中配置
TimeoutSec=300和RestartSec=10 - supervisord 配置
stopwaitsecs=300+startsecs=5 - 注意：此方式仅适用于非常驻型命令，不适用于
@Crontab这类由主服务托管的任务
