应避免用 PhpSpreadsheet 同步导出百万行 Excel，因其全量内存加载易导致内存溢出和超时；推荐禁用缓存+流式输出，或改用 Spout 实现低内存流式写入，并务必添加权限校验、参数过滤与异步降级。
Webman 中导出 Excel 报表，别硬扛 PhpSpreadsheet 处理百万行——它默认全量加载进内存，memory_limit 不够直接 500，max_execution_time 超时也常发生。真要导出海量数据，得绕开「一次性生成完整 Spreadsheet 对象」这条路。
为什么 PhpSpreadsheet 在 Webman 里导出大数据容易崩
PhpSpreadsheet 默认把整张表的单元格缓存到 PHP 内存中，每行每列都建对象实例。10 万行 × 20 列 ≈ 数百万 Cell 对象，轻松吃掉 512MB+ 内存；加上样式、公式、合并单元格等，实际开销翻倍。Webman 是常驻内存的 Swoole 应用，没有传统 PHP-FPM 的请求隔离，一个导出卡死可能拖垮整个 worker 进程。
常见错误现象包括：
Fatal error: Allowed memory size of ... bytes exhaustedMaximum execution time of ... seconds exceeded- 浏览器卡在 loading，Nginx 返回
504 Gateway Timeout - 导出文件打开后内容错乱或仅显示前几行
用 PhpSpreadsheet::setCacheEnabled(false) + 直接写入 php://output
禁用单元格缓存是第一步，但光关缓存不够——你还得跳过「先生成完整对象再输出」的惯性流程，改为边查边写、流式输出。
立即学习“PHP免费学习笔记（深入）”；
关键实操点：
- 调用
Settings::setCacheEnabled(false)全局禁用缓存（必须在 new Spreadsheet 前） - 不调用
$sheet->setCellValue()逐个设值，改用$sheet->fromArray($chunk)批量写入（每次最多 1000 行） - 不用
Xlsx::save()写文件，而用Xlsx::save('php://output')直接输出到响应流 - 每次写入一批后，手动调用
ob_flush(); flush();推送缓冲区，避免响应阻塞
示例片段（简化版）：
use PhpOffice\PhpSpreadsheet\Settings;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
<p>Settings::setCacheEnabled(false); // 必须放最前</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill6589" title="excel-clean"><img
src="https://img.php.cn/upload/skill/000/000/081/179102164382218.jpg" alt="excel-clean" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill6589" title="excel-clean">excel-clean</a>
<p>Excel 数据清洗——去重、填补缺失值、格式转换。</p>
</div>
<a href="/xiazai/skill6589" title="excel-clean" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();</p><p>// 分页查库，每次取 5000 行
$offset = 0;
$limit = 5000;
while (true) {
$rows = db()->table('orders')->select('*')->offset($offset)->limit($limit)->get();
if (!$rows) break;</p><pre class="brush:php;toolbar:false;">$sheet->fromArray($rows, null, 'A' . ($offset * $limit + 2)); // 从第2行开始写，留表头
$offset += $limit;
// 强制刷新输出缓冲
ob_flush();
flush();}
// 设置响应头 header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'); header('Content-Disposition: attachment; filename="orders_' . date('Ymd_His') . '.xlsx"');
$writer = new Xlsx($spreadsheet); $writer->save('php://output');
超 50 万行？换 Spout，别碰 PhpSpreadsheet
Spout 是专为大数据设计的轻量库，不解析 XML 结构，不建 Cell 对象，纯流式写入，内存恒定在 3–5MB，支持 .xlsx 和 .ods，但不支持样式、公式、图片、合并单元格。
适用场景明确：
- 纯数据报表（如日志导出、订单流水、用户清单）
- 需要支持 100 万+ 行且不能异步的同步导出
- Webman worker 内存受限（如 Docker 容器限制 256MB）
安装与基本写法：
composer require box/spout
代码要点：
- 用
WriterEntityFactory::createXLSXWriter()创建 writer - 先写
RowEntity表头，再循环写RowEntity数据行 - 全程无对象缓存，
$writer->writeRow()即刻刷入磁盘/输出流 - 中文需确保源数据是 UTF-8，Spout 原生支持，无需 BOM
Webman 导出接口必须加权限和防重放
导出接口本质是「高消耗资源型」端点，比普通 API 更容易被刷爆。Webman 没有 Laravel 那套中间件生态，默认不带限流、鉴权、防重复提交。
容易被忽略但极关键的点：
- 必须校验
$request->user()或 session，禁止未登录访问 - 对导出参数做白名单过滤，比如只允许
status=1或date_from=2026-01-01，禁用原始 SQL 注入式传参 - 加简单令牌（如
export_token），前端点击导出时由后端签发一次有效 token，防止 F5 刷屏 - 记录导出日志（用户 ID、时间、参数、耗时、文件大小），便于事后排查慢查询或恶意行为
最后提醒：哪怕用了 Spout，单次导出超过 200 万行仍建议走异步队列（如 Redis + Worker），前端返回「任务已提交，稍后查收邮箱」——这不是妥协，是 Webman 常驻模型下保障服务可用性的基本操作。
