根本原因是默认整表加载致内存爆满，应改用fromquery分批查库、启用batch缓存驱动、禁用请求依赖，并通过fromgenerator实现流式生成。

大数据量 Excel 导出在 Laravel 中卡住、内存爆掉、超时失败——根本不是 Laravel-Excel 本身慢，而是默认用法把整张表 load 进内存再生成文件。只要改掉数据来源方式和缓存策略，10 万行也能稳定导出，峰值内存压到 5MB 以内。

用 FromQuery 替代 FromCollection 处理万行以上数据

FromCollection 会先执行 ->get() 把全部结果转成 Collection，内存占用随行数线性增长；FromQuery 则让 Laravel-Excel 内部用 chunkById() 分批查库，每批只 hold 几百行原生数组，内存恒定。

• 导出类里必须实现 query() 方法，返回一个未执行的 Builder 实例，不能调 ->get() 或 ->cursor()
• 需要关联字段？别在 map() 里访问 $user->profile，得提前 select() 或 join() 进主查询
• 排序字段（如 id）必须有数据库索引，否则 chunkById() 会变慢甚至死锁

启用 batch 缓存驱动防内存溢出

默认 memory 缓存把所有单元格数据存在 PHP 数组里，10 万行轻松吃掉 200MB；batch 驱动会在内存达到阈值时自动刷到临时文件或 Redis，是大数据导出的标配。

Excel XLSX Formula Cleanup

诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿

下载

• 改 config/excel.php 中 'driver' => 'batch'，并设 'memory_limit' => 50000（单位 KB，即 50MB）
• 如果已配好 Redis，可直接切 'driver' => 'illuminate' + 'store' => 'redis'，多 Worker 场景下更稳
• 禁用缓存（'driver' => 'null'）只适合固定小表格，一开就报 Allowed memory size exhausted

用 FromGenerator 实现“流式生成”百万行

当数据源不是数据库（比如 API 拉取、计算生成、日志解析），或者你想彻底绕过 Eloquent 和查询构造器，FromGenerator 是唯一选择：它用 PHP yield 逐行产出数据，内存永远只有几 KB。

• 导出类实现 FromGenerator 接口，generator() 方法里写 yield ['ID', 'Name'] 开头，再循环 yield [...] 每行数据
• 每处理 1000 行手动触发 gc_collect_cycles()，防止 PHP 引用计数残留
• 别在 generator() 里做重 IO（如查库、发 HTTP 请求），否则会拖慢整体速度——应提前准备好数据流

控制器里传筛选参数，别在导出类里 request()->input()

导出类被 Excel::download() 调用时，HTTP 请求上下文可能已销毁，request() 返回空或默认值，导致导出全表而非筛选结果。

• 控制器中完成所有条件拼接：$query = User::where('status', $request->status)->when(...)
• 把最终的 Builder 或 Collection 传进导出类构造函数：new UsersExport($query)
• 导出类里只做纯数据映射，不碰请求、不查库、不判断条件——职责越单一，越不容易出错

真正难的不是写几行导出代码，而是想清楚数据从哪来、要不要实时查、能不能提前算好、有没有并发冲突。缓存驱动选错、接口用反、参数传偏，任何一个点没对齐，都会让“导出”变成“等超时”。