Laravel日志怎么查看_Laravel日志记录与调试技巧【详解】-Laravel-PHP中文网

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

laravel日志怎么查看_laravel日志记录与调试技巧【详解】

日志根本没写进去，90% 是 config:cache 没清、storage/logs 权限不对，或者 LOG_LEVEL 被设成了 error —— 不是代码漏写了 Log::info()，而是环境卡住了输出。

常见现象：调了 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

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

确认是否已安装官方推荐的 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 验证基础读取能力

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

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

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 全部静音

现象：生产环境页面空白或 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