深入理解 Eloquent update() 方法：避免意外更新脏数据

本文旨在深入探讨 Eloquent ORM 中 update() 方法的行为特性，特别是其在更新指定字段的同时，可能意外更新模型实例上已修改（脏）但未明确传入 update() 方法的属性。我们将分析其内部工作机制，并提供一种推荐的解决方案，即通过直接使用查询构建器进行更新，以确保仅更新目标字段，同时讲解如何保持模型实例与数据库同步。

Eloquent update() 方法的默认行为解析

在使用 eloquent orm 进行数据更新时，开发者常会遇到一个不符合直觉的现象：当通过模型实例调用 update() 方法并传入特定字段进行更新时，模型实例上在此之前被修改但未传入 update() 方法的“脏”属性也可能一并被更新到数据库中。

考虑以下代码示例：

$user = User::find(1); // 从数据库加载用户
$user->is_admin = 1; // 修改了 is_admin 属性，但尚未保存
$user->update(['first_name' => 'Alex']); // 意图只更新 first_name
// 结果：is_admin 字段也可能被更新为 1！

为什么会发生这种情况？原因在于 Eloquent Model 类的 update() 方法的内部实现。根据其源代码定义，update() 方法首先会调用 fill() 方法将传入的属性填充到模型实例中，然后紧接着调用 save() 方法。

/**
* Update the model in the database.
*
* @param  array  $attributes
* @param  array  $options
* @return bool
*/
public function update(array $attributes = [], array $options = [])
{
if (! $this->exists) {
return false;
}
return $this->fill($attributes)->save($options);
}

save() 方法的职责是保存模型实例的所有“脏”属性（即与从数据库加载时或上次保存后相比发生变化的属性）到数据库。因此，当 update() 方法被调用时，它不仅会保存传入 attributes 数组中的字段，还会将模型实例中所有在 update() 调用之前被修改过的其他属性一并保存。在上述示例中，$user->is_admin = 1; 这行代码已经将 is_admin 标记为“脏”属性，因此在 update([‘first_name’ => ‘Alex’]) 执行时，is_admin 也会被 save() 方法更新到数据库。

解决方案：使用查询构建器进行精确更新

为了避免这种意外的副作用，确保只更新指定的字段，推荐的方法是绕过模型实例的 save() 行为，直接使用 Eloquent 的查询构建器（Query Builder）进行更新。这样可以精确控制哪些字段会被修改。

$user = User::find(1); // 从数据库加载用户
$user->is_admin = 1; // 此时模型实例的 is_admin 属性已被修改
// 使用查询构建器直接更新数据库，只影响指定的字段
User::whereKey($user->getKey())->update(['first_name' => 'Alex']);
// 此时数据库中只有 first_name 被更新，is_admin 保持不变（除非之前就是1）
// 但请注意，内存中的 $user 实例的 first_name 仍是旧值，is_admin 仍是 1

重要注意事项：模型实例与数据库同步

当使用 User::whereKey($user->getKey())->update(…) 这种方式进行更新时，数据库中的记录会被修改，但内存中 $user 变量所引用的模型实例并不会自动更新以反映这些变化。如果后续操作依赖于 $user 实例的最新状态，你需要手动同步它。

有两种主要的同步方式：

1. 手动更新模型实例的属性：
   如果你知道哪些字段被更新了，可以直接设置模型实例的属性。同时，为了确保模型实例的“脏”状态正确，可以调用 setOriginalAttribute() 来更新其原始属性值。

   $user = User::find(1);
   $user->is_admin = 1;
   User::whereKey($user->getKey())->update(['first_name' => 'Alex']);
   // 手动更新内存中的模型实例
   $user->first_name = 'Alex';
   // 可选：更新原始属性以清除其“脏”状态，防止后续意外保存
   $user->setOriginalAttribute('first_name', 'Alex');
   // 此时 $user->first_name 已经是 'Alex'

2. 刷新模型实例：
   如果你不确定哪些字段被更新了，或者更新逻辑复杂，可以使用 refresh() 方法重新从数据库加载模型实例的最新数据。这会产生一次额外的数据库查询。

   $user = User::find(1);
   $user->is_admin = 1;
   User::whereKey($user->getKey())->update(['first_name' => 'Alex']);
   // 重新从数据库加载最新数据到模型实例
   $user->refresh();
   // 此时 $user->first_name 已经是 'Alex'，is_admin 保持数据库中的原值

   请注意，虽然 refresh() 会产生额外查询，但在某些复杂场景下，它可能是最稳健的同步方式。

总结

Eloquent 的 update() 方法在模型实例上调用时，会将其内部所有已修改（脏）的属性一并保存。如果需要精确控制只更新传入的特定字段，而不触及模型实例上其他已修改的属性，则应使用查询构建器（例如 Model::whereKey($id)->update([…])）进行更新。在使用查询构建器更新后，务必记住手动同步内存中的模型实例，或者通过 refresh() 方法重新加载以确保数据一致性。理解这些细微差别对于编写健壮和可预测的 Eloquent 代码至关重要。