应禁用非必要日志通道、精简查询日志输出、替换全量查询为指定字段、跳过敏感字段记录、关闭开发环境自动查询日志。

如果您在 Laravel 应用中发现日志文件体积过大、查询记录冗余或数据库写入频繁,可能是由于未对日志行为与查询逻辑进行针对性精简。以下是直接可执行的操作方案:
一、禁用非必要日志通道
默认 Laravel 的 stack 通道会聚合多个日志驱动(如 single、daily),若仅需调试阶段记录,应关闭生产环境中的冗余输出,避免重复写入。
1、打开 config/logging.php 文件。
2、定位到 'default' => env('LOG_CHANNEL', 'stack') 行,确认当前生效通道。
3、在 'channels' 数组中,将不使用的通道(如 'daily' 或 'syslog')的配置临时注释或设为 'driver' => 'null'。
4、确保 APP_ENV=production 时,LOG_LEVEL=error 已在 .env 中设置,防止 debug 级别日志写入。
二、精简数据库查询日志输出
Laravel 的查询日志(由 DB::enableQueryLog() 或 DEBUG 模式触发)默认记录完整 SQL、绑定参数及执行时间,易造成内存与磁盘压力;可通过配置限制其粒度。
1、在 config/database.php 中,找到对应数据库连接的配置项(如 'mysql')。
2、添加或修改 'options' => [\PDO::ATTR_EMULATE_PREPARES => false],避免预处理语句被模拟后生成冗余日志。
3、在 App/Providers/AppServiceProvider.php 的 boot() 方法中,插入以下代码以按需启用查询日志:
4、if (app()->environment('local')) { DB::listen(function ($query) { if (strlen($query->sql) > 500) return; \Log::debug($query->sql, $query->bindings); }); }
三、替换 Eloquent 全量查询为指定字段查询
使用 all() 或 get() 无筛选地获取全部字段,不仅增加网络传输量,还会使日志中记录冗长的 JSON 化数据;应显式声明所需列。
1、将 $users = User::all(); 替换为 $users = User::select('id', 'name', 'email')->get();
2、对关联查询,禁用隐式加载(eager loading)的全字段行为:使用 with(['profile:id,user_id,bio']) 显式限定关联模型字段。
3、在控制器中避免对集合调用 toArray() 前未做字段裁剪,改用 map() 提前投影:
4、$data = User::get()->map(fn($u) => ['id' => $u->id, 'name' => $u->name]);
四、跳过敏感字段的日志记录
中间件或模型观察者在记录操作日志时若包含 password、token、api_key 等字段,会导致日志文件含敏感信息且体积异常膨胀;必须在序列化前剥离。
1、在日志中间件中,调用 $request->except(['password', 'password_confirmation', 'token', 'api_key']) 过滤输入数据。
2、若使用模型观察者,于 ActivityLog::create() 前对变更数据执行白名单过滤:
3、$safeChanges = Arr::only($model->getChanges(), ['title', 'status', 'published_at']);
4、将 $safeChanges 传入日志创建,而非原始 $model->getChanges()。
五、关闭开发环境下的自动查询日志
当 APP_DEBUG=true 时,Laravel Telescope 或内置 Query Log 可能自动捕获每条 SQL;该行为在压测或批量任务中显著拖慢性能并膨胀日志。
1、检查是否已安装 laravel/telescope,若未用于当前环境,运行 php artisan telescope:install 后立即执行 php artisan telescope:prune --hours=1 并禁用监听:
2、在 config/telescope.php 中,将 'enabled' => env('TELESCOPE_ENABLED', false) 设为 false。
3、在 bootstrap/app.php 或服务提供者中,移除或注释掉 TelescopeServiceProvider::class 的注册行。
4、确认 DB::connection()->enableQueryLog() 未在任何全局作用域中被硬编码调用。


















