踩坑：PHP7.2导出Excel正常，升级7.3文件损坏需修复

一、问题场景

项目基于 ThinkPHP + PhpSpreadsheet 做订单 Excel 导出，线上长期稳定运行。

本次仅做 PHP 版本升级，代码一行未改，出现诡异问题：

PHP7.2：导出的 xlsx 文件，打开完全正常
PHP7.3：导出文件下载后，Excel 提示文件异常，需要修复才能打开

全程无报错、无日志、代码逻辑完全一致，纯版本兼容隐性坑。

二、问题根因（重点）

先说结论：和 PhpSpreadsheet 版本、业务数据无关，是 PHP7.3 输出缓冲区机制改了。

我之前的不规范写法：

将 Excel 导出逻辑全部写在 Service 层，内部直接输出 header 头，并且通过 php://output 直接打印二进制文件，控制器最后执行 return 返回。

两个版本的核心差异：

PHP7.2：二进制流输出后，框架后续的空输出、响应内容会被自动忽略，相当于侥幸避坑，所以文件正常
PHP7.3 ：输出流校验更严格，php://output 输出完 Excel 二进制数据后，脚本不会终止，控制器继续 return，ThinkPHP 会自动拼接响应内容、空行到文件末尾

这里很多人容易忽略：xlsx 文件本质是 zip 压缩包，只要文件头尾多一个多余字符、空行、HTML 代码，整个文件结构就会损坏，Excel 就会提示修复。

三、顺带发现的多处不规范代码

这次升级暴露了之前偷懒写的一堆问题，叠加导致故障：

MIME 头混用：导出 xlsx 文件，用了老式 xls 的 header 类型，高版本环境兼容性极差
分层逻辑错误：Service 层只该负责数据组装、业务逻辑，不能处理 HTTP 响应、文件下载
无缓冲区清理：没清空运行过程中的 notice 警告、空行输出，极易污染二进制文件
未终止脚本：导出完成后没有 exit，任由框架继续执行后续响应逻辑

四、最终修复方案（实测可用）

1. 重构 Service 层

只保留表格数据组装逻辑，删掉所有 header、文件输出、下载相关代码，只返回表格对象。

复制代码

public function orderList($list) { $spreadsheet = new Spreadsheet(); $sheet = $spreadsheet->getActiveSheet(); // 原有表头设置、单元格数据填充逻辑全部保留 // 只返回表格对象，不做任何输出操作 return $spreadsheet; }

2. 控制器统一处理下载逻辑

所有 HTTP 响应、文件输出、缓冲区清理全部放在控制器，禁止 return，导出后直接 exit 终止脚本，彻底杜绝多余输出。

复制代码

public function exportList($dataType, $query) { $list = $this->getListAll($dataType, $query); $spreadsheet = (new ExportService())->orderList($list); $filename = '订单-' . date('YmdHis') . '.xlsx'; // 清空所有缓冲区，清除空行、报错输出、BOM头污染 while (ob_get_level()) { ob_end_clean(); } error_reporting(0); ini_set('display_errors', 0); // xlsx 标准正确响应头 header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'); header("Content-Disposition: attachment;filename=\"{$filename}\""); header('Cache-Control: max-age=0'); $writer = IOFactory::createWriter($spreadsheet, 'Xlsx'); $writer->save('php://output'); // 关键：强制终止脚本，不让框架二次输出内容 exit; }

五、快速自查排错方法

遇到 Excel 导出损坏、需要修复的问题，直接按这两步排查，百试百灵：

用记事本打开损坏的 xlsx 文件，如果末尾有空白行、乱码、HTML 代码、PHP 报错，直接判定是输出流污染
本地生成文件测试：$writer->save('./test.xlsx')，本地能正常打开，说明表格生成逻辑没问题，问题百分百出在浏览器下载的 HTTP 输出环节

六、个人总结（开发避坑）

这次踩坑完全是老旧不规范代码 + PHP 版本机制变更导致的隐性 bug，总结几个以后固定遵守的规范：

PHP7.3 及以上版本，绝对不能依赖框架自动收尾，文件导出后必须手动 exit
严格分层：Service 只处理业务，控制器统一处理 HTTP 响应、文件下载
xlsx 和 xls 的响应头必须严格区分，不能混用
所有文件导出场景，必须先清空缓冲区、关闭错误输出，避免二进制文件被污染
旧环境能正常运行不代表代码没问题，很多都是版本兼容的侥幸容错