PHP_XLSXWriter浏览器输出xlsx文件Excel无法打开问题求助

• 响应头配置错误：代码中添加了Content-Transfer-Encoding: base64头，但writeToStdOut()方法输出的是未经过base64编码的原始xlsx二进制流，浏览器会按照base64规则对原始二进制内容做错误解码，最终下载到本地的文件内容完全损坏。
• 文件流被额外内容污染：xlsx本质是zip格式压缩包，结构对内容连续性要求极高。如果PHP脚本存在BOM头、起始标签前的空字符、运行时的Notice/Warning报错、文件末尾闭合标签后的空行等多余输出，这些内容会被拼接到xlsx流的头尾，直接破坏zip结构，导致Excel无法识别。写入磁盘时不会触发该问题，是因为writeToFile()方法仅将库生成的纯xlsx内容写入目标路径，不会混入其他脚本输出。

按以下步骤调整代码即可：

• 删除错误的Content-Transfer-Encoding: base64响应头，二进制xlsx流不需要该编码配置。
• 输出xlsx内容前清空所有已存在的输出缓冲区，抹除之前可能产生的所有多余输出。
• xlsx内容输出完成后立刻终止脚本执行，避免后续任何内容被追加到文件流末尾。

修复后的完整代码：

include_once("xlsxwriter.class.php");
$filename = "example.xlsx";
// 清空所有层级的输出缓冲区，清除提前输出的多余内容
while (ob_get_level()) {
    ob_end_clean();
}

header('Content-disposition: attachment; filename="'.XLSXWriter::sanitize_filename($filename).'"');
header("Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
header('Cache-Control: must-revalidate');
header('Pragma: public'); 

$rows = array(
    array('year','month','amount'),
    array('2003','1','220'),
    array('2003','2','153.5'),
);

$writer = new XLSXWriter();
$writer->writeSheet($rows);
$writer->writeToStdOut();
// 输出完成后立即终止脚本，阻止后续多余内容输出
exit;

额外排查点 #

如果调整后仍有问题，可逐一检查：

• 确保当前PHP文件保存为无BOM的UTF-8编码格式
• 移除PHP文件末尾的?>闭合标签，从语法层面避免标签后空行被当作内容输出
• 下载逻辑前可通过ob_start()开启输出缓冲，进一步拦截非预期的报错、调试内容

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