laravel队列超时需两级控制：任务$timeout属性与queue:work --timeout参数协同，核心解法是分块处理（游标分页）、限制重试（$tries/$backoff）、高风险操作降级（http超时、csv替代xlsx）并监控。
Laravel 队列任务执行超时，本质是单个任务耗时超出设定阈值，导致被强制终止、重试失败甚至堆积。解决关键不在“加时间”，而在于**精准控制执行边界 + 拆解不可控逻辑 + 主动降级兜底**。
明确超时的两层控制点
超时不是单一配置，而是“任务自身”和“队列进程”两级协同：
-
任务类内 $timeout 属性：定义该任务最多运行多少秒（如
protected $timeout = 90;），超时后抛出异常并触发重试逻辑 -
queue:work 命令的 --timeout 参数：决定 worker 进程对单个任务的硬性等待上限（如
php artisan queue:work --timeout=60），必须 ≤ 任务自身的 $timeout，否则任务还没来得及抛异常就被 kill 掉
避免超时的根本方法：分块与游标替代全量加载
多数超时源于在 handle() 中一次性查 10 万条数据再循环处理。应改为流式分页或游标分片：
- 用
DB::table('orders')->where('id', '>', $lastId)->limit(500)替代Order::all() - 每次处理完一批，记录最后主键 ID 到缓存或数据库，下个任务从该 ID 继续
- 导出场景可结合
CursorPaginator或自定义游标查询，内存占用稳定在 KB 级
失败重试必须带延迟与次数限制
无策略的重试会让问题雪上加霜。应在任务类中显式声明：
- $tries = 3：最多尝试 3 次（含首次），防止死循环
- $backoff = 60：首次失败后等 60 秒再重试，给数据库/第三方服务恢复时间
- $maxExceptions = ['Illuminate\Database\QueryException']：仅对特定异常重试，其他错误（如参数为空）直接失败不重试
高风险操作主动降级与监控
对可能长期阻塞的操作（如调用外部 API、生成大文件），需提前设防：
- 使用
Http::timeout(10)->get(...)限定 HTTP 请求时长 - 导出任务中改用 CSV 替代 XLSX，生成速度提升 5–10 倍，内存降低 80%
- 配合 Horizon 或自建日志埋点，监控
jobs.failed表和超时任务频次，及时发现慢查询或依赖瓶颈
