为什么Hyperf的日志中不显示请求ID_在Logger组件中配置ContextHandler-php教程-PHP中文网

hyperf日志不显示请求id，根本原因是contexthandler（实为自定义processor）未在logger配置中正确注册到formatter的processor数组，导致context::get('request_id')无法注入日志context；需确保中间件已设值、processor在同协程链路中调用、避免异步子协程丢失上下文。

为什么hyperf的日志中不显示请求id_在logger组件中配置contexthandler

Hyperf日志不显示请求ID，是因为ContextHandler没生效或没配对

默认的 Monolog\Handler\StreamHandler 不会自动读取协程上下文，ContextHandler 是 Monolog 官方提供的 Processor（非 Handler），必须显式注册到 logger 实例或 formatter 所在的 channel 配置中，否则 Context::get('request_id') 的值永远不会进入日志 message 或 context 字段。

确认你用的是 Monolog\Processor\IntrospectionProcessor 或自定义 Processor，而不是误以为某个 Handler 能“自动注入”上下文
ContextHandler 本身不存在于 Monolog 或 Hyperf 核心中——常见误区是把自定义 Processor 命名为 ContextHandler，但实际需继承 Monolog\Processor\ProcessorInterface
Hyperf 推荐做法是在 config/autoload/logger.php 的 formatter 配置里挂载 Processor，而非在 Handler 构造时传入
Processor 必须返回带 request_id 的数组，且该键名要与你在业务中 Context::set('request_id', ...) 设置的一致

在 logger.php 中正确注册上下文处理器

别只改 handler，重点在 formatter 的 processor 配置项。Hyperf 允许为每个 channel 单独指定 processor 数组，它会在日志写入前被依次调用。

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

先确保已在中间件或全局生命周期中设置了 request_id：Context::set('request_id', $request->getHeaderLine('X-Request-ID') ?: uniqid('req_'))
在 config/autoload/logger.php 的目标 channel（如 'file'）下，添加 'processor' => [App\Logger\RequestIdProcessor::class]
RequestIdProcessor 类需实现 __invoke(array $record): array，并在 $record['context']['request_id'] = Context::get('request_id') ?: 'unknown'
注意：Processor 运行在当前协程内，无需手动 Context::copy()，只要调用发生在同一协程链路中即可

为什么用了 Context::set 却 still 没日志？检查这三处

最常踩的坑不是代码写错，而是上下文根本没传到日志写入那一刻——尤其在异步、defer、go 启动的子协程里。

Context::set() 只作用于当前协程，go(function () { Context::get('request_id') }) 一定为 null，除非你显式 go(function () use ($context) { Context::set($context); })
数据库查询、Redis 调用等异步操作若触发了新协程（比如 Co::sleep() 或底层驱动协程切换），原始 request_id 就断了
日志写入发生在 @AfterReturning 切面里？那方法抛异常时该切面压根不执行——必须用 @Around 统一包裹，并在 try/catch 后再组装日志字段

Formatter 里直接读 Context 更稳，但要注意时序

比起靠 Processor 注入，有些场景更适合在自定义 Formatter 的 format() 方法里动态取值，因为 Formatter 总是在日志真正序列化前最后一步执行，上下文仍可读。

继承 Monolog\Formatter\LineFormatter，重写 format()，开头加一行：$record['message'] = '[' . (Context::get('request_id') ?: 'no-id') . '] ' . $record['message'];
不要在构造函数里缓存 Context::get() 结果，那只是初始化时刻的快照，后续协程里全失效
如果用了 JsonFormatter，记得把 request_id 写进 $record['context']，否则 JSON 输出里看不到
注意 LineFormatter 第五个参数 $allowInlineLineBreaks 设为 true，否则换行符会被转义，日志平台解析困难

Hyperf 日志里 request_id 看不见，问题几乎都出在“上下文没活到日志落盘那一刻”，而不是配置文件写错了哪一行。协程 ID 和请求 ID 的透传，本质是控制协程生命周期内的数据可见性，不是加个配置就能自动生效的事。