本文介绍如何在 laravel 中通过中间件（middleware）自动记录每次请求的路由信息到数据库，避免在每个控制器方法中手动调用日志函数，提升代码可维护性与一致性。
在 Laravel 开发中，为每个控制器方法手动插入日志调用（如 (new WebLogs)->createLogs()）不仅重复冗余，还违反了关注点分离原则，也极易遗漏或出错。理想的方案是将日志逻辑统一拦截、集中处理——而 Laravel 的中间件（Middleware）正是为此类横切关注点（cross-cutting concerns）量身定制的机制。
✅ 正确实践：使用中间件自动触发日志记录
中间件会在请求进入应用和响应返回之前执行，天然适合作为“日志钩子”。相比尝试重写 __call() 魔术方法（该方法仅对未定义方法生效，无法捕获已声明的 index()、showSomething() 等显式方法），中间件能精准、稳定、无侵入地覆盖所有匹配路由。
1. 创建日志服务类（app/Classes/WebLogs.php）
insert([
'route_name' => $routeName,
'route_path' => $routePath,
'ip_address' => request()->ip(),
'user_agent' => request()->userAgent(),
'created_at' => now(),
]);
Log::debug('WebLogs: log entry created', compact('routeName', 'routePath'));
return 1;
} catch (\Exception $e) {
Log::error('WebLogs failed', ['error' => $e->getMessage()]);
return 0;
}
}
}? 提示：确保已运行迁移创建 web_logs 表（含 route_name, route_path, ip_address, user_agent, created_at 字段）。
2. 创建中间件（app/Http/Middleware/AutoCreateLogs.php）
执行命令生成：
php artisan make:middleware AutoCreateLogs
填充逻辑（推荐使用依赖注入优化，但此处保持简洁）：
getName()) {
return $next($request); // 跳过匿名路由
}
$routeName = $route->getName();
$routePath = $route->uri();
// 自动记录日志
(new WebLogs)->createLogs($routeName, $routePath);
return $next($request);
}
}3. 注册并应用中间件
在 routes/web.php 中，将需记录的路由包裹在中间件组内：
use App\Http\Middleware\AutoCreateLogs;
Route::middleware([AutoCreateLogs::class])->group(function () {
Route::get('/', [DashboardController::class, 'index'])->name('dashboard');
Route::get('/something', [DashboardController::class, 'showSomething'])->name('something');
Route::post('/something/update', [DashboardController::class, 'updateSomething'])->name('something.update');
Route::get('/something/{value}', [DashboardController::class, 'getSomething'])->name('get.something');
});✅ 此时，所有被该中间件包裹的请求，在控制器逻辑执行前，均已自动完成日志写入 —— 控制器代码彻底解耦，无需任何日志调用。
⚠️ 注意事项与最佳实践
- 路由必须命名：->name('xxx') 是获取 $route->getName() 的前提，未命名路由将被跳过；
- 中间件顺序很重要：若需访问认证用户信息（如 auth），请确保 AutoCreateLogs 在 auth 中间件之后执行（即 ->middleware(['auth', AutoCreateLogs::class])）；
- 性能考量：高频请求下建议异步写入（如 dispatch job 或使用队列），避免阻塞主线程；
- 避免日志爆炸：可添加白名单/黑名单路由、排除 API 调试路径（如 /telescope, /horizon）或静态资源；
- 替代方案参考：高级场景可结合 Laravel 的 Event 系统（监听 Illuminate\Routing\Events\RouteMatched）或使用包如 spatie/laravel-activitylog。
✅ 总结
使用中间件实现“函数/路由调用自动日志”是 Laravel 最自然、最健壮的解决方案。它不依赖魔术方法陷阱，不污染业务逻辑，具备高复用性与可测试性。从今天起，让日志安静地发生在幕后，而你的控制器，只专注交付价值。
