根本原因是默认将整个文件读入内存再输出，必须绕过缓冲、流式传输、关闭干扰层：先执行while(ob_get_level())ob_end_clean();再flush();gc_disable();手动fopen+循环fread(8192)+echo+flush+ob_flush，禁用output_buffering和zlib压缩，并调优Nginx超时与gzip配置。
ThinkPHP 下载大文件（如几百 MB 甚至上 GB）时，卡顿、超时、内存溢出或下载中断，根本原因不是框架“限制”了大小，而是默认行为把整个文件读进内存再输出——这在大文件场景下必然崩溃。突破的关键是绕过缓冲、流式传输、关闭干扰层，而不是调高 memory_limit 或 time_limit。
必须关闭所有输出缓冲
ThinkPHP 默认启用多层 ob_start()，不清理会导致响应被截断或乱码：
- 在调用 download() 前加：while (ob_get_level()) ob_end_clean();
- 紧接着执行：flush(); 和 gc_disable();（可选，减少垃圾回收开销）
- 确保控制器方法最后是 return response()->download(...); 或直接 exit，避免后续代码输出空格/BOM污染响应流
不用 response()->download() 处理超大文件
TP6/8 的 response()->download() 内部仍基于一次性 readfile()，不支持 Range，也不做分块流控。对 >100MB 文件，应手动实现流式输出：
- 用
fopen($path, 'rb')打开文件，而非 file_get_contents() - 设置
Content-Type、Content-Disposition（中文名用 RFC5987 编码）、Accept-Ranges: bytes - 若需断点续传，解析
$_SERVER['HTTP_RANGE']，计算 offset/length，返回206 Partial Content并设置Content-Range - 循环
fread($fp, 8192)→echo→flush()→ob_flush()，每次只处理 8KB
路径与安全前置校验不能省
大文件下载更易暴露权限和路径漏洞，业务层三步缺一不可：
立即学习“PHP免费学习笔记（深入）”；
-
查数据库确认归属：比如
$file = FileModel::where('id', $id)->where('user_id', $this->userId)->find(); -
路径白名单限定：用
realpath($path)校验后，判断是否在runtime_path() . '/export/'等受控目录内 -
后缀强校验：只允许
['xlsx', 'pdf', 'zip', 'csv']，拒绝.php、.log等危险类型
服务端环境配合调优
光改 PHP 代码不够，Nginx 和 PHP-FPM 也要同步调整：
- PHP 配置：
output_buffering = Off、zlib.output_compression = Off、max_execution_time = 0 - Nginx 配置：
proxy_read_timeout 3600、fastcgi_read_timeout 3600、send_timeout 3600 - 禁用 gzip 压缩响应体：
gzip off;（二进制文件压缩无效且增加 CPU 负担）
