通过模型观察者、事件监听器和中间件三种方式实现Laravel操作日志记录，首先创建UserActionLog模型并迁移数据表，利用UserActivityObserver监听用户模型的增删改行为并写入日志；其次定义UserPerformedAction事件与LogUserAction监听器，支持异步队列处理复杂场景下的日志记录；最后通过LogUserActivity中间件拦截请求，记录用户访问路径、IP、操作时间等信息，并结合手动调用确保关键操作可审计，三者结合实现全面、灵活、可维护的日志系统。

如果您希望在 Laravel 应用中记录用户对系统资源的修改行为，例如创建、更新或删除操作，可以通过事件监听与模型观察者机制实现自动化日志收集。这种机制能够帮助开发者追踪用户行为，便于后期审计和问题排查。

本文运行环境：MacBook Pro，macOS Sonoma

一、使用模型观察者记录操作日志

模型观察者允许您将 Eloquent 模型的事件处理逻辑分离到独立的类中，使代码更清晰且易于维护。通过监听模型的 created、updated、deleted 等事件，可以捕获用户的具体操作并写入日志表。

1、执行 Artisan 命令生成日志模型和迁移文件：
php artisan make:model UserActionLog -m

2、编辑生成的迁移文件，在 up 方法中定义日志字段：

user_id、action_type、model_name、record_id、changes、ip_address、user_agent 是关键字段，应包含在迁移中。

3、运行迁移命令创建数据表：
php artisan migrate

4、创建观察者类：
php artisan make:observer UserActivityObserver --model=User

5、在生成的观察者类中实现 created、updated、deleted 方法，向 UserActionLog 写入相应记录。

6、在服务提供者如 AppServiceProvider 的 boot 方法中注册观察者：
User::observe(UserActivityObserver::class);

二、利用 Laravel 事件与监听器机制

Laravel 提供了强大的事件广播系统，您可以自定义事件并在监听器中处理日志写入逻辑。这种方式更适合复杂业务场景，支持解耦和异步处理。

1、定义一个事件类用于触发操作日志记录：
php artisan make:event UserPerformedAction

2、在事件类构造函数中接收用户、操作类型、目标模型及变更数据等参数。

3、创建对应的监听器：
php artisan make:listener LogUserAction --queue

4、在监听器的 handle 方法中实例化 UserActionLog 并保存日志信息。

5、在需要记录的地方分发事件：
event(new UserPerformedAction($user, 'update', $model, $changes));

6、为提升性能，可将监听器设置为队列任务，在配置中启用 shouldQueue 属性。

三、通过中间件记录路由访问日志

中间件可用于拦截 HTTP 请求，在请求进入控制器之前或之后执行日志记录操作。适用于记录页面访问、API 调用等行为。

1、创建自定义中间件：
php artisan make:middleware LogUserActivity

2、将中间件注册到 Kernel.php 的 $middlewareGroups 或单独命名使用。

3、在中间件的 handle 方法中获取当前用户（若已登录）、请求路径、请求方法、IP 地址等信息。

4、判断是否需要记录该请求（例如排除心跳检测接口），然后写入 UserActionLog 表。

5、对于敏感操作，可在控制器方法中手动调用日志服务进行精确控制。

6、确保中间件顺序正确，避免因前置认证中间件未执行导致用户信息为空。