PHP导出CSV至输出缓冲区后下载文件为空的原因排查

我来帮你拆解下问题根源，你当前的逻辑里有个核心错误，再加上可能的缓冲区处理疏漏，才导致最终下载的文件是空的：

1. 最关键的错误：readfile("php://output")用法完全错误 #

php://output是一个只写的输出流，它的作用是让你把数据直接写入到输出缓冲区，而不是一个可以用readfile读取的文件资源。你之前已经把CSV数据写入到这个流里了，结果又用readfile去读它——这就像从一个只允许往里倒水的水管里试图接水，自然拿不到内容，反而可能清空之前的输出。

2. 正确的CSV导出流程 #

把你的代码改成这个逻辑，就能正常导出CSV了：

// 第一步：彻底清理所有输出缓冲区，避免之前的残留内容（比如空格、换行、隐性错误提示）干扰
while (ob_get_level() > 0) {
    ob_end_clean();
}

// 第二步：设置响应头（必须在任何输出之前完成，否则头会失效）
header('Content-Type: application/csv');
header('Content-Disposition: attachment; filename="test.csv"');
header('Cache-Control: max-age=0');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');

// 第三步：打开输出流并写入CSV数据
$fp = fopen('php://output', 'w');
// 示例：写入表头和数据行
fputcsv($fp, ['姓名', '年龄', '邮箱']);
fputcsv($fp, ['张三', 25, 'zhangsan@example.com']);
fputcsv($fp, ['李四', 30, 'lisi@example.com']);

// 第四步：关闭流并结束脚本，确保没有后续输出干扰
fclose($fp);
exit;

3. 其他可能导致空文件的细节问题 #

• 缓冲区清理不彻底：如果只调用ob_clean()，可能还有多层嵌套的缓冲区没清理干净，用ob_end_clean()循环清空所有层级更稳妥。
• 响应头设置前有输出：如果在header()调用之前已经有任何输出（哪怕是PHP文件开头的空格、注释外的换行），会导致头设置失效，浏览器无法正确识别文件，表现为下载空文件。
• 错误被抑制：检查代码里有没有用@符号抑制错误（比如@fopen()），可以临时开启错误提示：error_reporting(E_ALL); ini_set('display_errors', 1);，看看是否有fopen或fwrite失败的报错。

内容的提问来源于stack exchange，提问作者Nikita Karpenko