PHP Process总超时与空闲超时有什么区别

在 Symfony Process 中，setTimeout() 和 setIdleTimeout() 不是两个名字相近的同类参数：前者看进程从启动到现在的总运行时间，后者看进程距离上一次产生输出已经安静了多久。实际项目里通常把它们一起设置，例如允许任务最多运行 30 分钟，但连续 90 秒没有任何输出就认为它可能卡住。

官方地址：https://symfony.com/doc/current/components/process.html

理解这两个边界后，最重要的取舍就很清楚：总超时负责防止任务无限延长，空闲超时负责发现“没有进展迹象”的长时间沉默。一个会持续打印日志却永远不退出的进程，仍然会被总超时终止；一个确实需要很久但中间没有输出的进程，则可能先触发空闲超时。

总超时与空闲超时分别保护什么

setTimeout(1800) 的计时从进程启动后累计计算，到了 1800 秒就会触发超时检查。它不关心标准输出是否持续产生内容，适合限制批处理、导出、编译等任务的绝对最长寿命。

setIdleTimeout(90) 只关注最近一次输出之后经过的时间。只要进程产生新的标准输出或错误输出，空闲计时的观察点就会被刷新；如果连续 90 秒都没有输出，就可能抛出超时异常。因此它更像“无进展保护”，不是总时长限制。

为什么通常要同时设置两个值

只设置总超时，能拦住最终不退出的任务，却无法尽早发现网络等待、死锁或子进程没有继续输出的情况。只设置空闲超时，又可能误杀一个本来就需要长时间计算、但设计上不会持续打印日志的命令。

比较稳妥的做法是给出两道不同方向的边界：总超时描述业务愿意等待的最大时长，空闲超时描述任务多久没有新迹象就需要人工关注。下面的数值只是配置示意，应该按任务实际输出节奏调整。

setTimeout(1800);
$process->setIdleTimeout(90);

// run() 会等待子进程结束，并把异常交给调用方处理。
$process->run();

官方文档还说明，Process 默认有 60 秒总超时；长任务必须显式调整。不要把一个很大的总超时当成“永不超时”，否则任务可能长期占用 PHP-FPM 或队列 worker。

四种输出行为该怎么判断

第一种是持续输出但不退出：空闲超时可能一直不触发，但总超时仍然会在累计时长达到上限后生效。第二种是启动后长时间没有输出：如果超过空闲阈值，会先暴露沉默问题。第三种是正常完成：两个计时器都不会阻止已经结束的进程，应该根据退出码和输出判断结果。第四种是非零退出：这不是超时，应该读取错误输出并按失败处理。

需要注意的是，空闲超时依赖“输出”这个信号。如果子进程把日志写入自己的文件、被缓冲层延迟刷新，或者本来就没有设计进度输出，那么空闲超时并不能代表业务真的没有进展。此时应优先调整命令的日志策略，或只使用总超时。

超时和失败时保留哪些信息

生产代码通常需要区分超时异常和普通失败，并保留标准输出、错误输出以及进程的退出状态。不要在异常分支里只记录“执行失败”，否则下次排查无法知道它是沉默、超时还是命令自身报错。

setTimeout(1800);
$process->setIdleTimeout(90);

try {
    $process->mustRun();
    $log('export.completed', [
        // 成功时保留完整标准输出，便于关联任务摘要。
        'stdout' => $process->getOutput(),
    ]);
} catch (ProcessTimedOutException $exception) {
    $log('export.timeout', [
        // 超时后同时保存标准输出和错误输出，区分总超时与空闲超时。
        'stdout' => $process->getOutput(),
        'stderr' => $process->getErrorOutput(),
        'message' => $exception->getMessage(),
    ]);
} catch (\Throwable $exception) {
    $log('export.failed', [
        // 非零退出不是计时器问题，错误输出通常包含真正的失败原因。
        'stderr' => $process->getErrorOutput(),
        'message' => $exception->getMessage(),
    ]);
}

如果任务是异步启动的，仍然要在循环或等待期间定期调用组件要求的超时检查逻辑；只设置数值而不进入实际的运行/等待路径，不能替代检查。对必须长期运行的作业，更适合交给队列系统，并让 worker 自己拥有明确的生命周期。

几个容易混淆的问题

持续打印日志的死循环会触发空闲超时吗？

不一定。只要确实不断产生输出，空闲条件可能一直不满足，但总超时仍可终止它。因此两者应当组合使用。

没有输出的正常长计算应该怎样配置？

把空闲阈值设得足够大，或不启用空闲超时，改用总超时保护；更好的方案是让命令输出低频、可靠的进度信号。

超时后只读标准输出够吗？

不够。标准错误经常包含退出原因、依赖缺失或外部命令的诊断信息，超时与普通失败都应同时保留两条输出流。

可以把选择归纳为一句话：总超时回答“最多允许它运行多久”，空闲超时回答“最多允许它多久没有新输出”。把二者按业务时长和输出节奏分别设置，再用异常类型、退出码和双通道日志做最后判断，通常比单独放大一个超时值更安全。