ThinkPHP日志不生效需检查log.type设为File、log.level包含info/debug、runtime/log目录可写；禁用Log::record()，改用Log::info()/debug()；自定义通道须预配置并确保路径存在；敏感信息应通过processor统一脱敏。
ThinkPHP 日志写入不生效？检查 log 配置和驱动类型
默认情况下 ThinkPHP 的日志可能只记录错误，或根本没写入文件——不是代码错了，而是配置没开对。关键在 log.type 和 log.level。
常见错误现象：Log::info('test') 没反应、日志目录空、runtime/log/ 下只有日期文件夹但无内容。
-
log.type必须设为File（大小写敏感），设成test或留空会静默失败 -
log.level默认是['error', 'notice']，info和debug不会写入，要手动加进去 - 确保
runtime/log/目录可写，且父目录runtime/存在（TP 不会自动创建多级目录）
记录业务流程时用 Log::record() 还是 Log::info()？
别用 Log::record() —— 它是内部方法，只在框架核心流程中被调用，外部调用无效，且文档已标记为“不推荐”。真正该用的是 Log::info()、Log::debug() 等标准接口。
使用场景：下单流程分步骤调试、支付回调链路追踪、多服务协同状态记录。
立即学习“PHP免费学习笔记（深入）”；
- 用
Log::debug()记录变量值、中间状态，比如Log::debug('order_id: ' . $order->id) - 用
Log::info()标记关键节点，如Log::info('payment callback received') - 避免在循环里高频打日志（如每条订单都
Log::info()），会拖慢响应；改用拼接字符串 + 单次写入
自定义日志通道写入独立文件（如 business.log）
直接往 runtime/log/ 下塞新文件？不行。ThinkPHP 要求所有日志通道必须预先在配置中声明，否则 Log::channel('business')->info() 会报错 Channel not exists。
参数差异：自定义通道不继承全局 log.level，需单独指定；也不走默认的日期分文件逻辑，得靠 file_format 控制。
- 在
config/log.php中新增通道配置，键名即 channel 名，例如：'business' => ['type' => 'File', 'path' => runtime_path() . 'log/business/', 'file_format' => '{Y-m-d}.log'] -
path值末尾必须带/，否则文件会生成在runtime/log/business（无后缀）而非business/目录下 - 首次写入前，确保
runtime/log/business/目录存在且可写，TP 不会自动创建它
日志内容含敏感信息？别依赖运行时过滤
很多人想在 Log::info() 前做 str_replace(['password', 'token'], '***', $data)，但容易漏字段、破坏 JSON 结构，还可能误删业务关键词。
更可靠的做法是利用 ThinkPHP 的日志处理器（processor）机制，在写入前统一脱敏。
- 写一个匿名函数作为
processor，放在通道配置里：'processor' => function($data) { return json_encode(array_map(function($v) { return is_string($v) && preg_match('/(token|key|pwd|pass)/i', $v) ? '***' : $v; }, $data)); } - 注意：这个函数接收的是原始日志数组（含
level,message,context），不是最终字符串，别直接对$data做json_encode后再塞回去 - 脱敏逻辑不能太重，否则影响请求性能；密码类字段建议在业务层就处理，日志只存 ID 或摘要
复杂点在于：不同业务流程的日志结构不一致，有的传数组，有的传字符串，有的带 trace。没做统一封装的话，context 里的数据很容易裸奔进文件。
