Monolog在PHP 7.3下日志截断主因是BufferHandler缓冲未及时flush或StreamHandler提前关闭；需显式调用flush()、合理配置bufferLimit和flushOnOverflow=true，并避免依赖析构函数。
Monolog 在 PHP 7.3 下写入日志时出现截断，大概率是 BufferHandler 的缓冲区未及时刷新，或底层 StreamHandler 在短生命周期请求中被提前关闭导致的。
BufferHandler 缓冲未刷出就结束请求
PHP-FPM 请求结束时，若 BufferHandler 中还有未 flush 的日志，它们会直接丢弃——这是最常见截断原因。PHP 7.3 默认不自动触发 __destruct() 中的 flush（尤其在 fastcgi_finish_request() 后），BufferHandler 的析构函数可能来不及执行。
- 确认是否调用了
fastcgi_finish_request()：一旦调用，PHP 进程会立即返回响应，后续的析构、注册的register_shutdown_function都不可靠 -
BufferHandler默认只在缓冲满（bufferLimit）或手动调用flush()时才写入；它不会在脚本结束时强制 flush - 不要依赖“脚本自然退出”来刷日志，必须显式控制
bufferLimit 和 flushOnOverflow 配置不当
bufferLimit 设为 0（默认）表示无上限缓冲，极易在高并发下吃光内存且永不 flush；设得太小又频繁刷盘，失去缓冲意义。而 flushOnOverflow 若为 false，缓冲溢出时直接丢弃日志，而非强制刷出。
- 生产环境建议设
bufferLimit = 100～500（视单次请求平均日志量定），避免内存累积 - 务必设
flushOnOverflow = true，防止溢出丢日志 - 搭配
level参数过滤低价值日志（如Logger::INFO以下），减少进缓冲的条目数
StreamHandler 底层文件句柄提前关闭
BufferHandler 本身不操作文件，它把日志批量交给底层处理器（如 StreamHandler）。若该处理器在 BufferHandler::flush() 前就被销毁（例如被 unset 或作用域结束），flush() 会静默失败，无报错、无日志。
立即学习“PHP免费学习笔记（深入）”；
- 确保
StreamHandler实例生命周期 ≥BufferHandler：不要在函数内 new 后直接 return，应注入或作为全局 logger 的一部分长期持有 - 避免在
try/catch或条件分支里临时创建StreamHandler，容易被 GC 提前回收 - 可在
register_shutdown_function()中主动调用$logger->flush()（但注意：仅对未被fastcgi_finish_request()截断的场景有效）
PHP 7.3 兼容性与替代方案
PHP 7.3 已停止维护，其 stream_set_write_buffer() 行为和 fclose() 时机存在细微差异，某些 SAPI（如 Apache mod_php）下 StreamHandler 的文件锁释放更迟缓，加剧截断风险。
- 升级到 PHP 8.0+ 可缓解（
BufferHandler在 8.0 后加强了析构 flush 保障） - 短期无法升级时，可降级使用
RotatingFileHandler替代BufferHandler + StreamHandler组合：它内部自带缓冲逻辑且 flush 更鲁棒 - 极端高可靠场景（如支付回调），绕过缓冲，直接用
StreamHandler并设$handler->setBubble(false)，配合error_log()或syslog()作兜底
真正危险的不是缓冲本身，而是把“缓冲”当成“延迟写入”的错觉——Monolog 的缓冲不保证持久化，只保证批量转发。任何依赖“脚本结束自动落盘”的配置，在 PHP-FPM 环境下都不可靠。
