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 实例的最新状态，你需要手动同步它。
有两种主要的同步方式：
-
手动更新模型实例的属性： 如果你知道哪些字段被更新了，可以直接设置模型实例的属性。同时，为了确保模型实例的“脏”状态正确，可以调用 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' -
刷新模型实例： 如果你不确定哪些字段被更新了，或者更新逻辑复杂，可以使用 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 代码至关重要。
