laravel excel 使用队列导出时，若仅调用 `onqueue()`，会导致后续子任务（如分块查询、文件写入等）仍默认投递到 `default` 队列，造成主进程阻塞、任务堆积；正确做法是使用 `allonqueue()` 确保整个导出流程（含 queueexport 及其依赖的 chunkexportjob、storeexceljob 等）均运行在指定队列中。
在 Laravel 中使用 maatwebsite/excel 进行大型数据导出并启用队列时，一个常见却隐蔽的问题是：导出任务看似“启动”，但实际卡住不动——例如 Horizon 日志显示 QueueExport 已 Processed，却无后续动作，直到下一次请求才突然批量执行 2–5 个任务。这并非 Excel 包本身故障，而是队列路由不一致导致的典型行为。
根本原因在于：->onQueue('exports') 仅作用于顶层 QueueExport 任务，而 Laravel Excel 在执行过程中会动态分发多个子任务（如 ChunkExportJob 用于分页查询、StoreExcelJob 用于保存文件），这些子任务默认仍使用 default 队列。若你的 Horizon 或 Supervisor 仅监听 exports 队列（如 --queue=exports），则这些子任务将被“丢进黑洞”——既不执行，也不报错，造成假性卡死。
✅ 正确解法：使用 allOnQueue() 替代 onQueue()
// ❌ 错误：仅 QueueExport 进入 'exports' 队列，子任务滞留 default 队列
(new OrdersExport($request))->queue('orders.xlsx')->onQueue('exports');
// ✅ 正确：强制整个导出工作流（含所有子任务）均使用 'exports' 队列
(new OrdersExport($request))->queue('orders.xlsx')->allOnQueue('exports');allOnQueue() 是 Laravel Excel 提供的关键方法，它会递归地为导出流程中所有派生任务设置相同队列名，确保端到端一致性。
? 补充验证与最佳实践：
-
确认队列监听配置：确保 Horizon 配置或 php artisan queue:work 命令明确监听目标队列：
php artisan horizon --queues=exports,default # 若需兼顾多队列 # 或仅监听 exports（推荐隔离） php artisan queue:work --queue=exports --tries=3
检查队列驱动与连接：确保 QUEUE_CONNECTION=redis（或 database）已正确配置，且 Redis 实例可访问（Horizon 依赖 Redis）。
日志增强排查：在 map()、query() 和 withMapping() 等关键方法中添加 \Log::debug()，结合 php artisan tinker 手动触发队列任务，观察日志是否按预期输出。
避免阻塞主线程：导出类中禁止使用同步文件操作（如 file_put_contents）、未超时的 HTTP 请求或数据库长事务——所有 I/O 应交由队列异步处理。
总结：Laravel Excel 的队列导出是一个多阶段流水线，onQueue() 仅控制入口，allOnQueue() 才是保障全链路队列一致性的黄金法则。修复后，Horizon 将稳定消费全部相关任务，导出性能与可靠性显著提升。
