绝大多数导出进度需求无需SSE，直接用header('Content-Type: text/csv')输出流即可；仅当导出耗时超5秒且需反馈中间状态时才适用SSE，并需关闭output_buffering、session锁和Web服务器缓冲，严格遵循SSE格式并主动推送完成消息。
PHP导出大文件时用户卡在白屏？用SSE前先确认是否真需要它
绝大多数“导出进度”需求其实不需要SSE——header('Content-Type: text/csv') 直接输出流，浏览器自己会显示下载进度条。只有当导出逻辑复杂（比如查库+计算+生成压缩包）、耗时超过5秒、且必须向页面反馈中间状态（如“已处理1200条”）时，才值得上SSE。
容易踩的坑：PHP默认开启output_buffering，会导致SSE消息被缓存，前端收不到实时推送；Apache的mod_deflate或Nginx的gzip也会拦截SSE流；另外，session_start() 会锁住session文件，阻塞后续请求，必须提前调用 session_write_close()。
- 检查php.ini：把
output_buffering设为Off或0 - Nginx配置里加
proxy_buffering off;和chunked_transfer_encoding on; - 导出脚本开头立刻执行
session_write_close()，别等后面再关
SSE连接被断开？重点检查PHP超时和HTTP服务器设置
SSE本质是长连接，但PHP的 max_execution_time、set_time_limit(0) 只控制脚本执行时间，不保证连接不断。真正决定连接存活的是Web服务器的超时配置：
- Apache：
Timeout指令默认60秒，需调大（如Timeout 300） - Nginx：
proxy_read_timeout默认60秒，必须匹配你的导出最大耗时 - PHP-FPM：
request_terminate_timeout若启用，会强制杀掉进程，务必设为0（禁用）
实操建议：在SSE脚本开头加 ignore_user_abort(true)，并每3秒发一次空消息（echo ":\n\n"），防代理或浏览器自动断连。
立即学习“PHP免费学习笔记（深入）”；
前端接收不到data字段？注意SSE格式的换行和冒号规则
SSE协议对格式极其敏感：每条消息必须以 data: 开头，结尾是两个换行符 \n\n，中间不能有空格或多余字符。常见错误是拼接JSON时漏了换行，或用了 json_encode() 后没手动补 \n\n。
示例正确写法：
echo "data: ".json_encode(['progress' => 45, 'msg' => '正在写入第892行'])."\n\n"; flush(); // 必须flush，否则PHP缓冲不吐数据
别用 echo "data: {\"progress\":45}\n" —— 单个换行会被忽略；也别用 ob_flush() 单独调用，要配 flush() 才生效。
导出完成后如何通知前端跳转？别依赖SSE的close事件
浏览器不会主动触发 eventsource.onclose，服务端断连时前端往往收不到通知。更可靠的做法是：导出结束时，SSE推送一条特殊消息（如 data: {"status":"done","url":"/download/20240521-abc123.zip"}\n\n），前端监听到后自行跳转或触发下载。
关键细节：
- URL必须是可直接访问的静态路径，别传临时文件路径（如
/tmp/export_abc123.csv） - 导出脚本最后一步要重命名或移动文件到web目录，避免竞态（比如刚推完URL，文件还没写完）
- 前端收到
done后，立刻关闭EventSource：es.close()，防止重复触发
最易被忽略的一点：SSE消息里的 url 要带完整协议和域名（如 https://example.com/download/...），否则前端用 window.location.href = data.url 会变成相对路径跳转失败。
