日志写不进去主因是未清config:cache、storage/logs权限不足或log_level设为error：需执行php artisan config:clear，确保www-data对storage/logs有写权，并将log_level设为debug以记录info及以上级别日志。

日志文件写不进去，90% 是 config:cache 没清、storage/logs 权限不对，或者 LOG_LEVEL 被设成了 error——不是代码没调 Log::info()，而是环境压根没让日志落盘。

storage/logs/laravel.log 为空？先查这三件事

常见现象：调了 Log::error('test')，但 storage/logs/laravel.log 里啥也没有；或只在本地有日志，上线后就消失。

• LOG_CHANNEL 配置是否生效？检查 .env 中是否写了 LOG_CHANNEL=stack（或 single），并确认 config/logging.php 里对应 channel 的 path 确实指向 storage_path('logs/laravel.log')
• 配置缓存是否过期？改完 .env 或 config/logging.php 后，必须运行 php artisan config:clear——开发中别跳这步，config:cache 反而可能锁死新配置
• storage/logs/ 目录权限够吗？Linux 下常见错误是 Web 用户（如 www-data）无写入权，用 ls -l storage/logs 看属组，再执行 chmod -R 755 storage/logs 和 chown -R www-data:www-data storage/logs

tail -f 看不到实时日志？别急着重装包

现象：执行 php artisan tail 报错 “command not found”，或运行后没输出、卡住、中途断连。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

• 确认是否已安装官方推荐的 spatie/laravel-tail（不是 Laravel 自带命令）；composer require spatie/laravel-tail 后还要 php artisan vendor:publish --provider="Spatie\Tail\TailServiceProvider"
• tail 命令依赖日志文件存在且持续写入，如果 laravel.log 本身为空，tail -f 就会静默等待——先手动触发一次 Log::info('ping') 确保有内容
• 宝塔等面板环境常因日志文件过大（>100MB）导致 tail 失效，可临时用 tail -n 50 storage/logs/laravel.log 验证基础读取能力

ERROR 找得到，但 DEBUG/INFO 不见？看 LOG_LEVEL 和通道定义

现象：Log::debug() 不落盘，但 Log::error() 正常；或 daily 通道写进去了，stack 却没反应。

• LOG_LEVEL 默认是 production 环境下的 error，开发时务必设为 debug，否则 debug/info 级别直接被过滤掉
• stack 通道是聚合器，它是否包含 single 或 daily？打开 config/logging.php 查 'stack' => ['channels' => ['single']]，如果写成 ['files'] 而实际没定义 files channel，日志就丢了
• Monolog 的 level 是「最低记录级别」，level => 'debug' 表示 debug 及以上（info、error……）都记；level => 'error' 则 debug/info 全被忽略

日志内容看不懂？重点盯 message、context 和堆栈末尾

Laravel 日志是 JSON 格式（默认）或单行文本（single 驱动），但真正有用的线索不在开头的 timestamp 或 level，而在 message 字段的原始异常描述，以及 context 里传入的变量快照（比如 DB 查询参数、用户 ID）。堆栈（trace）最后几行才是出问题的具体位置。

• 别从头逐字读，先搜 "message":" 或 Stack trace:，定位到异常本体
• context 里如果出现 "exception":{}，说明是未捕获异常，重点看里面的 file 和 line
• 常见陷阱：日志里显示 Class not found，但实际是自动加载失败，不是类名写错——检查 composer dump-autoload 是否执行，vendor/autoload.php 是否被正确引入

最常被忽略的是：日志行为由 APP_LOG 环境变量和 config/logging.php 共同控制，改了任一端却忘了同步另一端，就会出现“配置明明写了，但日志就是不按预期走”的情况。