同步导出excel在thinkphp中无法支撑5000行以上数据，必须异步队列处理；否则php-fpm进程卡死、nginx超时、用户重试导致重复任务堆积。核心原因是后端同步阻塞，前端防抖仅缓解表层问题，真实并发下会迅速占满worker并触发504错误，需结合think-queue与phpspreadsheet实现幂等、结构化参数、文件落地及安全下载机制。
同步导出 Excel 在 ThinkPHP 里撑不住 5000 行以上数据，必须走队列异步生成 —— 否则 PHP-FPM 进程卡死、Nginx 超时、用户反复点击导致重复任务堆积，这是硬伤，不是优化空间。
为什么不能用同步导出 + 前端防抖解决？
前端按钮禁用 + 防抖只是表层缓解，后端仍是同步阻塞。真实压测中：10 个并发导出请求进来，就会占满 PHP-FPM worker（默认常为 5–10），新请求排队超时，Nginx 报 504 Gateway Timeout；更糟的是，用户刷新页面重试，又提交一遍，队列里堆了 3 个 task_202605011050xx，但只有第一个在跑，其余全浪费资源。
- ThinkPHP 自带的
queue:work或queue:listen必须配合 Redis/Database 驱动，不能用 sync 驱动（它根本没异步） - 导出任务必须幂等：同一份查询条件，重复提交应复用已有任务 ID，而不是新建
- 任务内容不能存原始 SQL 字符串（如
"SELECT * FROM user WHERE status=1"），而应序列化成结构化参数（如['table' => 'user', 'where' => ['status' => 1]]），避免 SQL 注入和字符编码污染
如何用 thinkphp-queue + phpspreadsheet 实现可靠队列导出？
核心是把「查数据 → 写 Excel → 存文件 → 返回下载链接」整个链路拆出队列任务，控制器只负责发任务、查状态、返链接。
- 安装：
composer require topthink/think-queue+composer require phpoffice/phpspreadsheet - 配置
config/queue.php使用redis或database，禁用sync - 定义任务类：
app\job\ExportExcelJob，handle()方法里做三件事：
① 用Db::table()->where(...)->select()查数据（别用Db::query()拼 SQL）
② 实例化Spreadsheet，用setCellValue()循环写入（>5000 行时每 1000 行调gc_collect_cycles()）
③ 写入本地临时目录（如runtime/export/），文件名用任务 ID 命名（task_202605011050xx.xlsx），并更新数据库记录状态为done和file_path - 控制器中
exportSubmit()只做两件事：
① 生成唯一任务 ID（建议用md5(serialize($params).time())）
② 推送任务：Queue::push(ExportExcelJob::class, $jobData, 'export')，立刻返回['task_id' => 'task_202605011050xx']
导出文件存储与下载要注意什么？
别把 Excel 直接 echo 到响应体，队列任务里必须落地为文件；用户下载时也不能读取 runtime 下的原始路径（有安全风险），要走代理或签名 URL。
- 文件必须存在可公开访问的路径下，比如
public/export/，而非runtime/（Web 无法直访） - 写入前检查磁盘空间：
disk_free_space(sys_get_temp_dir()) （50MB），不够就拒绝任务并记日志 - 下载接口（如
/export/download?task_id=xxx）要做校验：
① 查询该task_id是否存在且状态为done
② 文件物理存在且未过期（建议 24 小时自动清理）
③ 响应头必须含：Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet; charset=utf-8和Content-Disposition: attachment;filename="xxx.xlsx"，中文文件名用rawurlencode() - 临时文件清理不能依赖 crontab 脚本，应在下载成功后立即 unlink，或由另一个清理队列任务兜底
真正难的不是写几行 Queue::push，而是任务失败重试逻辑、大字段（如 text/blob）导出时的内存控制、以及并发下文件名冲突 —— 这些不提前想清楚，上线后就是凌晨三点的报警电话。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
