如何调试Laravel Eloquent事件监听器？JSON字段更新被合并问题排查

一、列出所有saving事件监听器的方法 #

要定位哪个监听器修改了属性，可以直接从Laravel的事件调度器中获取绑定到目标模型saving事件的所有监听器：

1. 在代码中打印监听器详情
   在调用save()或update()之前，添加以下代码（替换成你的模型类）：

$dispatcher = app(\Illuminate\Events\Dispatcher::class);
$eventName = 'saving:' . \App\Models\YourModel::class; // 替换为你的模型类
dump($dispatcher->getListeners($eventName));

输出结果会包含所有绑定的监听器：

• 类方法监听器会直接显示类名和方法名，可直接定位到对应文件；
• 闭包监听器会显示其所在的文件路径和行号，帮你快速找到代码位置。

2. 结合Artisan命令辅助排查
   执行php artisan event:list可以查看在EventServiceProvider中注册的全局事件监听器，但注意这个命令不会显示模型boot方法中直接绑定的监听器，需要和上面的代码配合使用。

二、JSON字段自动合并的原因及解决 #

Laravel默认不会自动合并JSON字段，出现你描述的合并行为，大概率是业务代码中的逻辑导致的，常见场景及解决方法如下：

1. 检查模型的字段修改器 #

查看你的模型中是否定义了setCountsAttribute方法，如果存在类似合并逻辑的代码：

// 错误的合并逻辑示例
public function setCountsAttribute($value)
{
    $this->attributes['counts'] = array_merge($this->counts ?? [], $value);
}

修改为直接赋值即可：

public function setCountsAttribute($value)
{
    $this->attributes['counts'] = $value;
}

2. 排查saving/updating事件监听器 #

检查模型的boot方法或EventServiceProvider中，是否绑定了针对该模型的saving或updating监听器，其中可能存在手动合并JSON字段的代码，比如：

// 模型boot方法中的错误逻辑示例
static::saving(function ($model) {
    $model->counts = array_merge($model->getOriginal('counts'), $model->counts);
});

删除或修改这类合并逻辑即可解决问题。

3. 验证数据库实际执行的SQL #

可以启用查询日志，确认数据库层面是否真的执行了合并操作：

DB::enableQueryLog();
$model->update(['counts' => ['three' => 30, 'four' => 40]]);
dump(DB::getQueryLog());

查看输出的UPDATE语句中counts字段的值，如果是合并后的结果，说明监听器在修改属性；如果是预期的新数组，那可能是模型实例的属性被后续代码修改了。

内容的提问来源于stack exchange，提问作者John Mellor