Laravel日志切single模式需将default设为single、确保single通道驱动为single且path可写；daily驱动通过days控制保留天数，文件名由RotatingFileHandler固定生成；自定义通道需独立配置driver和path，并用tap注入Formatter；LOG_LEVEL限制输出等级，生产环境默认error级不输出debug。
Laravel 默认用的是 stack 通道，背后其实是 daily 驱动 —— 想要单文件日志或自定义格式，不能只改 config/logging.php 里的 default，得同步调整驱动、通道、处理器和日志路径权限。
怎么把 Laravel 日志切到单文件（single）模式
默认的 daily 每天一个文件，适合生产；但开发调试时想 grep 全量日志，single 更直接。关键不是换驱动，而是确保通道不走 stack 套娃：
-
config/logging.php中把'default' => 'single' - 确认
'single'通道存在且驱动为'single'，不是嵌套在stack里 -
'path'必须可写，比如storage/logs/laravel.log，Laravel 不会自动创建父目录 - 如果用了
APP_ENV=local却没生效，检查.env是否被php artisan config:clear清过缓存
return [
'default' => 'single',
'channels' => [
'single' => [
'driver' => 'single',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
],
],
];
每日日志（daily）的保留天数和文件名控制
daily 驱动默认只保留 7 天日志，且文件名带日期后缀（如 laravel-2024-06-15.log），但命名和清理逻辑藏在 Monolog\Handler\RotatingFileHandler 里，Laravel 只暴露了有限配置：
-
'days'控制保留天数，设为30就留一个月，设0表示不删除旧文件 -
'filename'不能直接改——daily固定用date()拼接，想自定义前缀只能重写Handler - 注意：日志轮转发生在首次写入当天新日志时，不是定时任务，所以
2024-06-15.log可能一直空着，直到第一条日志写入 - 如果发现日志没按天分割，大概率是
storage/logs/权限不足，PHP 进程无法创建新文件
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
'days' => 30,
],
自定义日志通道（比如 payment）并指定格式
业务敏感操作（如支付、退款）需要单独归档、结构化记录，不能混在主日志里。Laravel 支持用 tap 扩展处理器，但更稳的方式是注册独立通道 + 自定义 Formatter：
- 在
config/logging.php新增通道，driver用single或daily，'path'指向专用路径（如storage/logs/payment.log） - 用
'tap'数组注入自定义类，该类必须实现__invoke方法，接收Logger实例 - 在
tap类中调用$logger->getHandlers()[0]->setFormatter(...)替换格式器，比如用LineFormatter输出 JSON - 调用时用
Log::channel('payment')->info('order_paid', ['order_id' => 123]);，别用Log::info()，否则走默认通道
use Monolog\Formatter\LineFormatter;
return [
'channels' => [
'payment' => [
'driver' => 'single',
'path' => storage_path('logs/payment.log'),
'level' => 'info',
'tap' => [App\Logging\CustomPaymentFormatter::class],
],
],
];
为什么 Log::debug() 在生产环境不输出
不是代码问题，是 LOG_LEVEL 环境变量或配置限制了最低输出等级。Laravel 的 level 是 Monolog 的级别，debug ，而生产环境默认 LOG_LEVEL=error：
- 检查
.env中LOG_LEVEL=debug是否生效，运行php artisan tinker后执行config('logging.channels.stack.level')看实际值 -
LOG_LEVEL只影响stack通道及其子通道，单独定义的single通道需显式设'level' => 'debug' - 如果用了
syslog或papertrail驱动，debug级日志可能被远程服务过滤，本地storage/logs/里反而看不到 - 最隐蔽的坑：某些部署（如 Forge）会覆盖
LOG_LEVEL，得去服务器环境变量里确认
真正难调的从来不是配哪个 driver，而是当 storage/logs/ 权限不对、LOG_LEVEL 被多层覆盖、或者自定义 tap 类抛了异常却没日志可查时，连问题出在哪都摸不到。先跑通 php -r "error_log(\Log::channel('single')->getLogger()->getLevel());"，再动其他。
