本文介绍 Laravel Eloquent 提供的 wasChanged() 方法，用于精准判断模型在最近一次保存操作中是否发生了真实数据变更，从而实现“仅在数据真正改变时才记录日志”的可靠逻辑。
本文介绍 laravel eloquent 提供的 `waschanged()` 方法，用于精准判断模型在最近一次保存操作中是否发生了真实数据变更，从而实现“仅在数据真正改变时才记录日志”的可靠逻辑。
在 Laravel 应用开发中，常需在模型持久化后执行审计、日志或通知等副作用操作，但关键前提是：仅当数据确实发生变更时才触发。若模型字段值未变却执行了 save()（例如调用 $model->save() 但所有属性与数据库当前值一致），Eloquent 默认不会执行 UPDATE 查询，但仍会重置脏状态（isDirty() 返回 false），导致传统判断方式失效。
你最初尝试的写法：
$myModel->save();
if ($myModel->isDirty()) { // ❌ 总是 false —— save() 后脏状态已被清空
Log::info('Model changed');
}无法满足需求，因为 isDirty() 是瞬态判断，反映的是「自上次同步后是否有未保存的修改」，而非「本次 save 是否导致了数据库变更」。
✅ 正确解法：使用 wasChanged() 方法
该方法是 Eloquent 内置的语义化工具，专为解决此类场景而设计。它不依赖当前内存状态，而是基于模型最近一次成功保存（save()、update() 或批量更新）时的底层 SQL 执行结果进行回溯判断——只要 ORM 确认有字段被实际更新（即执行了非空 UPDATE 语句），wasChanged() 就返回 true。
$myModel->name = 'Updated Name';
$myModel->status = 'active';
// 即使 name 和 status 在数据库中原本就等于这些值，save() 也不会执行 UPDATE，
// 此时 $myModel->wasChanged() 将返回 false
$myModel->save();
if ($myModel->wasChanged()) {
Log::info('Model was persisted with actual changes', [
'model' => get_class($myModel),
'id' => $myModel->id,
'changes' => $myModel->getChanges(), // 获取具体变更字段及新旧值
]);
}? 提示：
$model->getChanges()返回一个关联数组，形如['name' => ['old_value', 'new_value']]，可用于精细化日志输出或变更比对。
此外，wasChanged() 支持细粒度校验：
-
wasChanged('email')→ 判断email字段是否在本次保存中被修改； -
wasChanged(['email', 'phone'])→ 判断任一指定字段是否变更（Laravel 10.28+）； -
wasChanged()（无参）→ 判断是否存在任意字段变更。
⚠️ 注意事项：
-
wasChanged()的状态仅在当前请求生命周期内有效，不跨请求持久化； - 它仅对通过 Eloquent 主动调用的
save()/update()/fill()->save()等生效；原生 DB 查询或DB::table()->update()不会触发该状态； - 若模型使用了
timestamps且updated_at被自动更新（即使其他字段未变），wasChanged()仍返回false—— 因为 Laravel 将时间戳视为“系统维护字段”，不计入业务变更判定（除非显式修改updated_at值）； - 在事务中使用时，
wasChanged()行为不变，但日志应结合事务成败统一处理，避免部分写入成功时日志与数据不一致。
总结：无需手动缓存 isDirty() 状态，也无需引入复杂事件监听或事务包装。wasChanged() 是 Laravel 官方推荐、轻量且语义清晰的标准方案，让变更感知既准确又可维护。
