ThinkPHP 6 注册自定义日志处理器需实现 LoggerInterface 并在容器中绑定，不可在 config/log.php 中直接配置类名；真异步须用 Swoole Process 而非队列，且需透传 trace_id 等上下文避免日志失真。
ThinkPHP 6 如何注册自定义日志处理器
ThinkPHP 6 默认使用 think\log\driver\File，但不支持直接替换为异步写入逻辑；必须通过实现 think\log\LoggerInterface 并在容器中绑定才能生效。
常见错误是试图在 config/log.php 中直接填类名字符串（如 'type' => 'AsyncFile'），这会触发 ClassNotFoundException —— 因为框架只内置了 file、socket、error_log 等有限类型，不识别自定义类名。
- 正确做法：在
app/provider.php或服务提供者中调用Container::getInstance()->bind(LoggerInterface::class, AsyncLogger::class) - 自定义处理器类必须实现
write()方法，接收$level、$message、$context三个参数 - 不要在
write()内做阻塞操作（如同步 file_put_contents），否则仍会拖慢请求
用 Swoole Process 实现真正异步日志写入
仅靠「把日志内容推到队列再另起进程处理」不算真异步——TP 请求线程仍需等待队列推送完成。Swoole 的 Process 才能脱离 HTTP 生命周期。
关键点在于：主进程 fork 出守护子进程，通过 pipe 或 table 接收日志数据，自身不阻塞。
立即学习“PHP免费学习笔记（深入）”；
- 在
server.php或命令行启动脚本中创建Swoole\Process，调用start()后立即detach() - 主进程用
process->write()发送日志，子进程用process->read()持续消费 - 避免在子进程中使用
Log::write()，防止递归调用触发死锁或内存泄漏 - 子进程需手动处理
SIGTERM信号，确保平滑退出时 flush 缓存日志
示例片段（子进程核心逻辑）：
$process = new Swoole\Process(function ($process) {
while ($data = $process->read()) {
[$level, $msg] = json_decode($data, true);
file_put_contents(RUNTIME_PATH . 'log/async_' . date('Y-m-d') . '.log',
date('Y-m-d H:i:s') . " [{$level}] {$msg}\n", FILE_APPEND);
}
});
为什么不能直接用 think-queue + Redis 做日志异步
表面上可行，实际在高并发下容易丢日志或严重延迟，原因很实在：
- TP 的
Log::write()是同步调用，即使你封装成Job，也得等dispatch()完成才返回，而 RedisLPUSH在网络抖动时可能耗时几十毫秒 - 队列消费者若挂掉，日志就卡在 Redis 中，无人消费，且 TP 日志系统无重试机制
- Redis 内存占用不可控：突发流量下日志堆积，可能触发
OOM或被驱逐 - 日志时间戳变成「入队时间」而非「记录时间」，排查问题时时间线错乱
注意日志上下文与 Trace ID 的透传问题
异步后，$context 里常见的 trace_id、request_id 很容易丢失，因为子进程没有父进程的 Request 对象。
必须在主进程写日志前，显式提取并序列化上下文：
- 在中间件或日志处理器中调用
App::get('request')->header('x-request-id')获取 ID - 把
trace_id、uri、ip等关键字段提前塞进$context，再传给异步通道 - 不要依赖
debug_backtrace()或__FILE__等动态信息——子进程路径和堆栈完全不同
异步日志最难的从来不是「怎么写进去」，而是「写进去的内容是否还对得上请求」。漏掉上下文，等于白做。
