ReactPHP HTTP服务器需手动运行事件循环且请求体须流式处理：必须调用Loop::get()->run()启动循环，$request->getBody()返回的ReadableStreamInterface需监听data/end/error事件拼接数据，否则读取失败或截断。
ReactPHP HTTP 服务器启动失败：EventLoop 未显式运行
ReactPHP 的 HttpServer 不会自动启动事件循环，这是最常被忽略的前提。写完 new HttpServer() 就以为服务起来了，结果进程秒退——因为没调用 $loop->run()。
- 必须手动获取并运行
Loop实例，常见写法是Loop::get()->run()或显式创建StreamSelectLoop - 如果项目里已用其他异步库（如 Amp），不能混用 Loop，ReactPHP 要求独占事件循环
-
Loop::get()在首次调用时才初始化，但多次调用返回同一实例；若提前被销毁（比如测试中 mock 过），会抛出RuntimeException
请求体读取不到或截断：没处理 ReadableStreamInterface
ReactPHP 不像传统 PHP 那样直接提供 $_POST 或完整 $HTTP_RAW_POST_DATA，请求体是流式到达的，不手动拼接就只能拿到碎片。
- 对
$request->getBody()返回的ReadableStreamInterface，必须监听data、end、error事件 - 大文件上传时，别一次性
$stream->read(8192)——read()在非阻塞模式下可能返回null或空字符串，应依赖事件回调 - 简单 JSON 接口可用
BufferStream收集：先new BufferStream()，再$body->on('data', fn($chunk) => $buffer->write($chunk))，等end后取$buffer->getContent()
路由和中间件缺失：ReactPHP 本身不带 Router 或 MiddlewareStack
ReactPHP 的 HttpServer 只负责连接和请求分发，URL 匹配、参数解析、CORS、JSON 响应封装全得自己写，不是“装上就能用”的框架。
- 不要试图复用 Laravel/Symfony 的中间件——它们依赖同步生命周期，和 ReactPHP 的事件驱动模型不兼容
- 路径匹配建议用
preg_match()或str_starts_with()+ 手动拆解$request->getUri()->getPath()，避免引入重量级路由库破坏轻量性 - 响应构造必须手动设置
Content-Type和状态码：new Response(200, ['Content-Type' => 'application/json'], json_encode([...]))，漏掉头信息会导致前端解析失败
生产环境跑不稳：没处理 Connection: keep-alive 和超时
本地跑通不代表能上线。默认配置下，长连接不关闭、请求无超时、错误未捕获，几个并发就让服务卡死或内存暴涨。
立即学习“PHP免费学习笔记（深入）”；
- 给
HttpServer传入['timeout' => 30]选项，否则慢请求会一直占着连接 - 监听
connection事件时，务必用$connection->on('error', ...)捕获底层 socket 错误，否则异常会静默丢失 - 不要在回调里做阻塞操作（如
file_get_contents、sleep()、同步 DB 查询）——整个事件循环会被拖住，所有请求排队等待
