PHP使用XLSXWriter生成Excel通过JSON下载时文件损坏求助

1. 语法错误导致的多余输出 #

你的代码里有一行明显的语法错误，这会直接输出多余字符串到响应中，破坏Excel文件结构：

header("Content-Disposition: attachment; filename=\"$filename\"");filename="'.XLSXWriter::sanitize_filename($filename).'"");

这行需合并为正确的header调用，将文件名 sanitize 后再设置：

$sanitized_filename = XLSXWriter::sanitize_filename($filename);
header("Content-Disposition: attachment; filename=\"$sanitized_filename\"");

2. 清除输出缓冲 #

若PHP在输出Excel内容前存在空白字符、echo输出或其他缓冲内容，会导致文件开头混入多余字节，引发损坏。在输出文件前添加缓冲清理代码：

// 清除所有输出缓冲
ob_clean();
// 关闭输出缓冲
ob_end_flush();

3. 避免JSON格式的额外输出 #

你提到通过JSON调用实现下载，但Excel是二进制内容，不能与JSON格式混合输出。需确保接口触发下载时，仅输出Excel二进制内容，删除所有echo json_encode(...)这类JSON输出代码。

修正后的完整代码示例 #

$writer = new XLSXWriter();
$sheet_name = '360';
$writer->writeSheetHeader($sheet_name, $row_headers); 
$writer->writeSheetRow($sheet_name, $row); 

$filename = $lastname . ".xlsx";
$sanitized_filename = XLSXWriter::sanitize_filename($filename);

// 处理跨域和下载头
header("Access-Control-Expose-Headers: Content-Disposition, Content-Type");
header("Access-Control-Allow-Methods: GET"); 
header("Access-Control-Allow-Origin: *");
header("Content-Disposition: attachment; filename=\"$sanitized_filename\"");
header("Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
header('Content-Transfer-Encoding: binary');
header('Cache-Control: must-revalidate');
header('Pragma: public');

// 清除输出缓冲，避免多余内容
ob_clean();
ob_end_flush();

$writer->writeToStdOut();
// 终止脚本，防止后续代码输出
exit;

额外检查点 #

• 确认$row_headers和$row的数据格式正确（你存服务器正常，这部分大概率无问题）。
• 前端请求时需正确处理二进制响应：比如使用responseType: 'blob'（axios场景），创建下载链接，不要将响应当作JSON解析。

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