Laravel 9升级至Laravel 10后自定义MySQL日志失效报500错误

以下是针对你遇到的自定义日志失效问题的具体排查和修复步骤：

1. 先定位具体错误原因 #

500 错误只是通用提示，首先查看具体错误日志才能精准解决：

• 查看 Laravel 内置日志：storage/logs/laravel.log
• 查看服务器（Nginx/Apache）的错误日志，获取详细报错信息（比如类找不到、变量未定义等）

2. 修复 Monolog 3.x 兼容性问题 #

Laravel 10 默认升级到 Monolog 3.x，和 2.x 有两处关键差异影响你的自定义 Handler：

日志级别常量迁移 #

Monolog 3.x 将日志级别常量从Monolog\Logger移到了Monolog\Level枚举类，同时构造函数参数类型有变更。

修复MySQLLoggingHandler.php #

<?php

namespace App\Logging;

use App\Models\Logs; // 修正模型引用：原代码写的是Log，实际模型是Logs
use Monolog\Level;
use Monolog\Handler\AbstractProcessingHandler;

class MySQLLoggingHandler extends AbstractProcessingHandler
{
    public function __construct($level = Level::Debug, bool $bubble = true) 
    {
       parent::__construct($level, $bubble);
    }

    protected function write(array $record): void
    { 
       // 避免CLI环境下$_SERVER变量不存在报错
       $remoteAddr = php_sapi_name() === 'cli' ? 'cli' : ($_SERVER['REMOTE_ADDR'] ?? null);
       $userAgent = php_sapi_name() === 'cli' ? 'cli' : ($_SERVER['HTTP_USER_AGENT'] ?? null);
       
       $logs = new Logs();  
       $logs->message = $record['message'];
       $logs->context = json_encode($record['context']);
       $logs->level = $record['level'];
       $logs->level_name = $record['level_name'];
       $logs->channel = $record['channel'];
       $logs->record_datetime = $record['datetime']->format('Y-m-d H:i:s');
       $logs->extra = json_encode($record['extra']);
       $logs->formatted = $record['formatted'];
       $logs->remote_addr = $remoteAddr;
       $logs->user_agent = $userAgent;
       $logs->save();   
    }
}

3. 修正日志通道配置冗余 #

你的mysql通道同时配置了handler和via，这是 Laravel 自定义日志通道的冗余配置，driver: custom只需要via指定工厂类即可：
修改config/logging.php中的mysql通道：

'mysql' => [
    'driver' => 'custom',
    'via' => App\Logging\MySQLCustomLogger::class,
    'level' => env('LOG_LEVEL', 'debug'),
    'name' => 'mysql', // 可选：给Logger指定名称，替代硬编码值
],

4. 优化自定义 Logger 类（可选，符合 Laravel 10 规范） #

让MySQLCustomLogger利用传入的配置参数，避免硬编码：

<?php
namespace App\Logging;

use Monolog\Logger;
use App\Logging\MySQLLoggingHandler;
use Monolog\Level;

class MySQLCustomLogger
{
    public function __invoke(array $config)
    {
        // 使用配置中的channel名称
        $logger = new Logger($config['name'] ?? 'mysql');
        // 从配置中读取日志级别
        $level = $config['level'] ?? Level::Debug;
        return $logger->pushHandler(new MySQLLoggingHandler($level));
    }
}

5. 最后验证步骤 #

1. 清除配置缓存：php artisan config:clear
2. 调用日志测试：Log::channel('mysql')->info('This is test');
3. 检查logs表是否有新数据，同时查看storage/logs/laravel.log是否有新报错

内容的提问来源于stack exchange，提问作者Mona Alahmadi