日志未写入主因是config:cache未清、storage/logs权限不足或LOG_LEVEL设为error；需依次检查LOG_CHANNEL配置、清缓存、修正目录权限，并确认stack通道包含有效子通道及LOG_LEVEL级别匹配。

日志根本没写进去，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 Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

• 确认是否已安装官方推荐的 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 全部静音

线上不敢开 APP_DEBUG=true，怎么快速定位 500 错误？

现象：生产环境页面空白或 500，浏览器看不到任何提示，但 laravel.log 里也没 ERROR 记录。

• 先确认异常是否被 app/Exceptions/Handler.php 拦截却没上报——检查 report() 方法里有没有漏掉 parent::report($exception)，或加了 return 提前退出
• 某些中间件（如 JWT 验证、权限校验）抛出的异常若未被 render() 显式处理，也可能静默吞掉，建议在 report() 开头加一行 Log::emergency('Unhandled exception: ' . $exception->getMessage());
• 如果用了队列任务，错误默认不进主日志，要查 storage/logs/queue-*.log 或监听 Illuminate\Queue\Events\JobFailed

最常被忽略的一点：日志写入失败时，Laravel 默认不会报错，也不会 fallback 到其他通道——它就真的沉默了。所以每次部署后，务必手动触发一条 Log::info('deploy-' . now()->timestamp) 并立刻去文件里确认是否落地。