升级 laravel 后日志写入失败,通常是因为配置文件中的 app_log 或 log_channel 设置与新的日志驱动不兼容,或者文件权限未正确配置。请检查 config/logging.php 中当前环境使用的通道(如 single 或 daily)是否指向了有效的磁盘路径,并确保运行 web 服务器的用户对该目录拥有写权限。

如何确认当前日志驱动配置是否正确
在 Laravel 8 及更高版本中,日志系统默认使用 stack 驱动作为主通道,并通过 channels 数组定义具体的后端实现。如果升级后日志停止写入,第一步是确认 config/logging.php 中的 default 值是否与你的预期一致。例如,若你希望使用单文件日志,需确保 default 指向 single 通道,且该通道的 driver 设置为 single,path 指向 storage/logs/laravel.log。若配置为 syslog 或 errorlog,则日志将写入系统日志而非应用日志文件,这常被误认为是“写入失败”。

return [
'default' => env('LOG_CHANNEL', 'stack'),
'stack' => [
'driver' => 'stack',
'channels' => ['single'],
],
'single' => [
'driver' => 'single',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
],
];
上述代码展示了标准的单文件日志配置。运行 php artisan config:clear 清除缓存后,Laravel 会重新加载此配置。若 LOG_CHANNEL 环境变量被错误覆盖,可能导致实际使用的驱动与预期不符。通过 Log::info('test'); 测试写入,并检查 storage/logs/ 目录下是否有新文件生成,可验证配置是否生效。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
如何解决因权限或路径导致的日志写入失败
即使配置正确,若 Web 服务器用户(如 www-data 或 nginx)对 storage/logs/ 目录没有写权限,日志写入也会静默失败或抛出异常。在 Linux 系统中,需执行 chmod -R 775 storage/logs 并设置组所有权为 chown -R www-data:www-data storage/logs。此外,若使用了 daily 驱动,需确保 storage/logs/ 目录下存在按日期命名的子目录结构,否则可能因无法创建新文件而失败。

// 测试权限与写入
$testFile = storage_path('logs/test_permission.log');
try {
file_put_contents($testFile, 'Permission test', FILE_APPEND);
echo "Write successful";
} catch (\Exception $e) {
echo "Write failed: " . $e->getMessage();
}
通过上述 PHP 脚本直接测试文件写入,可快速定位是否为权限问题。若脚本执行成功但 Laravel 日志仍失败,可能是 Laravel 的日志通道配置中 path 指向了不可写的绝对路径。建议将 path 改为相对路径或使用 storage_path() 辅助函数,以确保路径解析正确。同时,检查 .env 文件中 LOG_LEVEL 是否设置了过高的级别(如 critical),导致低优先级日志未被记录,但这不会导致“写入失败”,仅影响可见性。
当使用 daily 驱动时如何排查日志轮转失败
若配置中使用 daily 驱动,Laravel 会在每天午夜自动轮转日志文件。升级后若发现旧日志未清理或新日志无法写入,可能是由于 max_files 参数设置不当或磁盘空间不足。检查 config/logging.php 中 daily 通道的 max_files 值,默认通常为 5。若磁盘空间接近上限,日志写入可能被操作系统拒绝。此时需清理旧日志文件或扩展磁盘空间,并重启 Web 服务以释放文件句柄。

















