PHP后端SSE前端收不到数据，主因是响应头被覆盖、输出缓冲未禁用、Web服务器缓冲未关闭、脚本超时未处理及消息格式错误；需确保header生效、flush输出、set_time_limit(0)、ignore_user_abort(true)，并校验Nginx/Apache配置与SSE协议格式。
PHP后端能发SSE，但前端收不到数据？先确认响应头是否生效
PHP本身不拦截SSE流，问题几乎都出在响应头被覆盖或未正确输出。关键不是header()写了没，而是它有没有被后续操作（比如框架自动输出、错误日志、BOM字符）破坏。
-
header('Content-Type: text/event-stream')必须在任何输出前调用，包括空格、BOM、echo ''、var_dump() - 禁用输出缓冲：
ob_end_clean()或ob_get_level() > 0 && ob_end_flush()，否则数据卡在缓冲区不推送 - 检查是否有框架中间件（如Laravel的HTTP中间件、ThinkPHP的Filter）悄悄写入了响应体或重置了Header
- 用curl测试原始响应：
curl -i http://your-domain.com/sse.php
看返回里是否有Content-Type: text/event-stream且无Content-Length
前端EventSource一直pending或报错net::ERR_INCOMPLETE_CHUNKED_ENCODING
这是典型的流式响应被意外截断或服务端提前关闭连接。PHP默认执行超时（max_execution_time）会直接杀掉脚本，导致SSE连接中断。
- 必须在PHP脚本开头加：
set_time_limit(0)和ignore_user_abort(true) - 每次发送数据后，强制刷新输出：
echo "data: ".json_encode($msg)."\n\n"; flush(); ob_flush(); - Nginx需禁用缓冲：
location /sse.php { proxy_buffering off; proxy_cache off; proxy_http_version 1.1; } - Apache若用mod_php，确保
php_flag output_buffering off
已配置；若用FPM，检查fastcgi_buffering off
已配置；若用FPM，检查PHP收到请求却没触发SSE逻辑？检查路由和请求方法
SSE本质是长连接GET请求，很多现代PHP框架默认对GET以外的方法做拦截，或把SSE路径误判为静态资源。
- 确认前端用的是
new EventSource('/api/sse')，不是POST或带body的fetch - Laravel中，确保路由定义为
Route::get('/sse', [SseController::class, 'stream'])，且不在VerifyCsrfToken中间件白名单外 - ThinkPHP中，关闭路由映射的自动后缀检测（
'url_html_suffix' => ''），避免/sse.php被重写 - 用浏览器DevTools → Network → XHR/EventStream标签，看请求是否真的到达PHP文件，还是被CDN、反向代理缓存了
数据发出去了，但前端onmessage收不到？注意data字段格式和换行规则
SSE协议对消息格式极其敏感：每条消息必须以data:开头，结尾用两个换行符\n\n分隔，多行data需每行都加data:。
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
echo "data: {\"msg\":\"ok\"}\n";（少一个\n） - 正确写法：
echo "data: " . json_encode(['msg' => 'ok']) . "\n\n"; flush();
- 如果要发ID或事件类型：
echo "id: 123\n"; echo "event: update\n"; echo "data: hello\n\n";
- 避免在
data:后拼接HTML或含换行的字符串——会被拆成多行，触发解析失败
