laravel excel 使用队列导出时，若仅调用 `onqueue()`，会导致主导出任务进入指定队列，但后续分片处理任务仍走默认队列，造成“看似运行实则卡住”的假象；正确做法是使用 `allonqueue()` 确保整个导出流程（含分片、写入、存储等所有子任务）统一调度到同一自定义队列。

当使用 Laravel Excel 的 QueueExport 实现异步导出时，你可能会观察到 Horizon 控制台中仅显示单条 Processing → Processed 日志，随后任务停滞，直到下一次请求才“突然”批量执行 2–5 个任务——这并非程序崩溃，而是队列路由不一致导致的任务分流问题。

根本原因在于：Laravel Excel 3.1+ 的导出流程被拆分为多个阶段（如查询分页、逐块写入、临时文件合并、最终存储），其中：

• QueueExport 主任务（入口）受 onQueue(‘exports’) 影响；
• 但后续由 ChunkReader 触发的分片导出子任务（如 AppendQueryExport、StoreExport 等）默认仍提交至 default 队列，除非显式声明。

✅ 正确写法（强制全部子任务进入 ‘exports’ 队列）：

// ✅ 推荐：使用 allOnQueue()
(new OrdersExport($request))->queue('orders.xlsx')->allOnQueue('exports');

❌ 错误写法（仅主任务进 exports，子任务仍在 default）：

Bing图像创建器

必应出品基于DALL·E的AI绘图工具

下载

// ❌ 危险：子任务将滞留在 default 队列，可能无 worker 处理
(new OrdersExport($request))->queue('orders.xlsx')->onQueue('exports');

? 补充关键配置建议：

1. 确保 exports 队列有活跃 Worker
   在 config/queue.php 中确认 exports 已声明，并在 Horizon 配置中启用：

   // config/horizon.php
   'environments' => [
       'production' => [
           'supervisor-1' => [
               'connection' => 'redis',
               'queue' => ['exports', 'default'], // 至少包含 exports
               'balance' => 'auto',
               'processes' => 4,
           ],
       ],
   ],

2. 验证日志与失败回调
   你的 failed() 方法已正确实现，但建议补充 __construct() 中的日志追踪点，确认参数传递无误：

   public function __construct(public array $request) 
   {
       /Log::info('OrdersExport instantiated with request', $request);
   }

3. 避免阻塞主线程的调试陷阱
   Log::critical(‘Query’) 出现在 query() 方法中，但该方法仅在 worker 进程中执行（非 HTTP 请求线程），因此控制台或 Web 日志中不会实时显示——请检查 storage/logs/laravel.log 或对应队列 worker 的 stdout 输出。

? 总结：->allOnQueue(‘xxx’) 是 Laravel Excel 队列导出的「必须项」，而非可选项。它通过底层 dispatchSync() 和 dispatch() 的统一队列策略，确保导出生命周期内所有 Job 均被正确路由，从而消除“卡顿-突增”现象，实现稳定、可预测的后台导出能力。

https://www.php.cn/faq/1995094.html