关键在于所有服务必须绕过本地文件写入，改用结构化、可路由的日志输出方式，并由外部采集器接管传输链路；否则set_error_handler+monolog仍会因致命错误中断、同步写失败、容器日志丢失或filebeat配置缺陷导致日志丢失。
PHP微服务架构中，统一收集自定义错误处理日志的关键在于：**所有服务必须绕过本地文件写入，改用结构化、可路由的日志输出方式，并由外部采集器接管传输链路**。直接用 error_log() 或 StreamHandler 写本地文件，等于主动放弃集中化能力。
为什么 set_error_handler + Monolog::addRecord 仍会丢失日志
很多团队在每个微服务里配置了 set_error_handler()，再调用 $logger->error()，但线上仍发现部分警告（如 E_WARNING）没进ELK。根本原因是：
-
set_error_handler()不处理致命错误（E_ERROR、E_PARSE），这些错误发生时脚本已中断，Monolog对象可能未初始化或无法执行 - Monolog 的
addRecord()默认同步写文件，若日志路径权限不足、磁盘满或 handler 配置为StreamHandler，错误会被静默吞掉，且无 fallback 机制 - 微服务常以容器方式部署，
/var/log/下的文件在容器重启后丢失，Filebeat 若未配置close_inactive和harvester_buffer_size，会漏采最后几秒日志
必须用 SocketHandler 或 SyslogHandler 替代文件写入
本地文件是集中化的最大障碍。要确保日志从 PHP 进程发出那一刻就脱离宿主环境，推荐两种稳定方案：
- 使用
SocketHandler直连日志聚合端（如 Logstash TCP input 或自研 UDP 收集器）：$handler = new Monolog\Handler\SocketHandler('tcp://log-collector:5000');
注意开启useSSL参数防中间人，且 Logstash 需配置tcp { port => 5000 codec => json } - 改用系统级转发：配置
SyslogHandler，让日志进入rsyslog，再由 rsyslog 转发至远程服务器。$handler = new Monolog\Handler\SyslogHandler('php-microservice', 'local6');
对应 rsyslog 配置需加一行：*.* @logs.example.com:514;json-template，并定义json-template格式保证结构化
自定义错误处理器必须做错误降级和上下文补全
仅捕获异常不够。PHP 原生错误（E_NOTICE、E_DEPRECATED）需在 set_error_handler() 中显式转成结构化日志，且必须补全请求上下文，否则 Kibana 里查不到来源：
- 在错误处理器里强制注入
$_SERVER['REQUEST_URI']、$_SERVER['HTTP_X_REQUEST_ID']（如有）、microtime(true)耗时，避免只记$errstr - 对
E_ERROR等不可恢复错误，无法调用 Monolog，应改用syslog(LOG_ERR, $message)，确保至少进系统日志 - 所有日志必须用 JSON 格式输出（Monolog 的
JsonFormatter），禁用LineFormatter—— 非结构化文本会让 Filebeat 解析失败，字段全变成message字段里的字符串
容器环境下 Filebeat 配置最容易被忽略的三个点
即使 PHP 端发出了正确日志，Filebeat 在容器里也常因以下配置缺失导致采集断流：
-
paths必须指向容器内可读路径，例如/var/www/logs/*.log，而不是宿主机路径；若用stdout模式，则需在 Dockerfile 中重定向：php-fpm -y /etc/php/php-fpm.conf 2>&1 | tee /proc/1/fd/1 - 必须设置
close_inactive: 5m，否则轮转后的旧日志文件不会被关闭，harvester 占着句柄不释放，新日志写不进去 - 启用
processors做字段提取：processors:<br>- add_fields:<br> target: ''<br> fields:<br> service: user-service<br>- decode_json_fields:<br> fields: ['message']<br> process_array: false
否则 Kibana 里看到的是原始 JSON 字符串，不是展开的字段
真正难的不是把日志发出去，而是让每条日志在 Kibana 里能按 service、trace_id、level 精准过滤，并且错误堆栈不被截断。这要求从 PHP 错误处理器的第一行代码开始，就假设自己运行在无文件系统、无持久存储、网络随时抖动的环境里——所有“默认行为”都要被质疑和替换。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
