laravel事务日志记录有五种方法:一、db::listen监听sql;二、手动包裹事务并注入日志上下文;三、扩展db门面重写事务方法;四、使用telescope事务探测器;五、利用db::transaction回调捕获异常。

如果您在 Laravel 应用中执行数据库事务时遇到逻辑异常或数据不一致问题,但缺乏上下文追踪能力,则可能是由于事务内部操作未被记录。以下是实现 Laravel 事务执行日志记录的多种方法:
一、使用 DB::listen 监听查询事件
该方法通过 Laravel 的数据库查询监听器捕获所有执行的 SQL 语句,包括事务开启、提交与回滚指令,并可结合当前事务状态进行标记。适用于全局范围的轻量级调试。
1、在 AppServiceProvider 的 boot 方法中注册监听器。
2、调用 DB::listen 回调函数,检查 $query->sql 是否包含 'begin', 'commit', 'rollback' 关键字。
3、使用 Log::channel('transaction')->info() 记录带时间戳、连接名和 SQL 内容的日志条目。
4、为每条日志添加 事务ID(如 uniqid('txn_')) 以关联同一事务内的多条语句。
二、手动包裹事务并注入日志上下文
该方法在业务代码中显式控制事务边界,利用 try-catch 捕获异常并在关键节点写入结构化日志,确保事务生命周期各阶段均可追溯。
1、在事务开始前生成唯一事务标识符并存入 Illuminate\Support\Facades\Log 的上下文栈。
2、调用 DB::transaction() 匿名函数,在其内部第一行记录 "事务启动:{事务ID}"。
3、在 try 块末尾记录 "事务准备提交:{事务ID}"。
4、在 catch 块中记录 "事务已回滚:{事务ID},异常:{类名}({消息})"。
5、在 finally 或闭包结束处记录 "事务结束:{事务ID}"。
三、扩展 DB 门面注入事务钩子
该方法通过继承 Illuminate\Database\Connection 并重写 beginTransaction、commit、rollback 方法,实现对底层事务操作的无侵入式日志埋点,适合需要统一管控多个模型事务场景。
1、创建自定义连接类 CustomLoggingConnection,继承原 Connection 类。
2、重写 beginTransaction 方法,在调用 parent::beginTransaction() 前记录 "BEGIN TRANSACTION [{连接名}] {时间戳}"。
3、重写 commit 方法,在调用 parent::commit() 后记录 "COMMIT [{连接名}] {时间戳}"。
4、重写 rollback 方法,在调用 parent::rollback() 后记录 "ROLLBACK [{连接名}] {时间戳}"。
5、在 database.php 配置中将默认 connection 的 driver 替换为该自定义类。
四、利用 Laravel Telescope 的事务探测器
该方法借助 Telescope 扩展包内置的 QueryWatcher 和 TransactionWatcher 组件,自动采集事务相关元数据,无需修改业务代码即可获得可视化调试支持。
1、执行 composer require laravel/telescope --dev 安装扩展包。
2、运行 php artisan telescope:install 和 php artisan migrate 启用服务。
3、在 config/telescope.php 中启用 'queries' => true 和 'transactions' => true。
4、触发含 DB::transaction 的请求后,访问 /telescope/requests 查看对应请求下的 事务起止时间、嵌套层级、影响行数 等字段。
五、使用 DB::transaction 的回调参数传递日志句柄
该方法利用 Laravel 8.0+ 支持的 transaction 方法第三个参数(超时秒数之后的可选回调),在事务失败时接收异常对象并直接写入日志,聚焦于错误路径的精准捕获。
1、调用 DB::transaction(function () { ... }, 60, function (Throwable $e) { ... })。
2、在回调函数中获取当前事务的 调用栈 trace 并截取前五行。
3、从 $e->getTrace() 提取触发事务的控制器方法与行号。
4、记录包含 "事务因 {异常类} 在 {文件}:{行号} 失败,堆栈摘要:{摘要}" 的日志。











