Eloquent update() 方法的内部机制
在使用Eloquent时，开发者经常会遇到一个关于update()方法的常见误解。当通过一个模型实例调用$model->update(['attribute' => 'value'])时，许多人会认为只有传入数组中的字段会被更新。然而，Eloquent的update()方法实际上是一个便利函数，其内部实现会首先调用fill()方法填充传入的属性，然后紧接着调用save()方法。
查看Illuminate\Database\Eloquent\Model类的update()方法定义，可以清晰地看到这一行为：
/**
* 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()方法的作用是将模型实例上所有已修改（即“脏”）的属性持久化到数据库中。这意味着，如果在一个模型实例上修改了某个属性（例如$user->is_admin = 1;），但尚未调用save()，此时再通过该实例调用update()方法更新其他字段，那么之前修改的is_admin属性也会被一并保存到数据库。
示例：意外更新脏属性
考虑以下代码片段：
$user = User::find(1); // 从数据库加载用户 $user->is_admin = 1; // 修改了is_admin属性，但尚未保存 // 此时调用update()方法更新first_name $user->update(['first_name' => 'Alex']); // 结果：is_admin 字段也会被更新为 1 // 数据库中的用户记录，其 first_name 变为 'Alex'，is_admin 变为 1
在这个例子中，即使update()方法只指定了first_name字段，但由于is_admin属性在update()调用前已被修改，save()方法会在更新first_name的同时，也将is_admin的值同步到数据库。这可能与开发者的预期不符，导致数据不一致或意外的副作用。
解决方案：通过查询构建器进行精确更新
为了避免update()方法带来的这种“脏属性”副作用，并实现只更新指定字段的目的，最直接且推荐的方法是绕过模型实例的save()逻辑，直接使用Eloquent的查询构建器（Query Builder）进行更新操作。
通过查询构建器，我们可以精确地指定要更新的记录和字段，而不会受到模型实例上“脏属性”状态的影响。
// 1. 获取模型实例（如果需要其ID或进行其他操作）
$user = User::find(1);
// 2. 在模型实例上修改了is_admin属性，但我们不希望它被更新到数据库
$user->is_admin = 1;
// 3. 使用查询构建器精确更新特定字段
// 此时，只有first_name字段会被更新，is_admin不会受到影响
User::whereKey($user->getKey())->update(['first_name' => 'Alex']);
// 4. 重要：如果模型实例 $user 在后续代码中仍被使用，
// 需要手动同步其状态以反映数据库的最新变化。
// 否则，$user->first_name 仍然是旧值，is_admin 仍然是 1（本地未保存的状态）。
$user->first_name = 'Alex'; // 更新模型实例的 first_name
$user->setOriginalAttribute('first_name', 'Alex'); // 将 first_name 标记为原始状态，避免再次保存
// 或者，如果需要刷新所有属性，可以使用 $user->refresh(); (但会产生额外查询)代码解析：
- User::whereKey($user->getKey()): 这会创建一个新的查询构建器实例，针对ID为$user->getKey()（即用户ID为1）的记录。这种方式确保了更新操作是针对数据库中的特定行，而不是通过内存中的模型实例。
- ->update(['first_name' => 'Alex']): 在查询构建器上直接调用update()方法，这会生成一条SQL UPDATE语句，只更新first_name字段。此时，模型实例$user上的is_admin属性的修改不会影响到数据库。
维护模型实例的一致性
当使用查询构建器直接更新数据库时，内存中的模型实例$user并不会自动同步这些变化。这意味着，如果后续代码仍然依赖于$user实例，它的属性值可能与数据库中的实际值不一致。
为了保持模型实例与数据库的同步，你有以下几种选择：
-
手动更新模型实例： 如果只更新了少量已知字段，可以直接在模型实例上设置这些字段的新值。为了避免这些手动设置的字段在未来再次调用save()时被误认为是“脏”属性并重新保存，可以使用setOriginalAttribute()方法将其标记为原始状态。
$user->first_name = 'Alex'; $user->setOriginalAttribute('first_name', 'Alex'); -
刷新模型实例： 如果更新的字段较多，或者不确定哪些字段被更新，可以使用$user->refresh()方法从数据库中重新加载该模型的所有属性。这种方法虽然方便，但会产生一次额外的数据库查询。
$user->refresh(); // 从数据库重新加载所有属性
总结与最佳实践
- 理解$model->update()： 当通过模型实例调用update()时，它会先填充传入的属性，然后调用save()方法，这会持久化模型实例上所有已修改的“脏”属性。
- 精确更新： 如果你只想更新数据库中特定字段，而不希望任何模型实例上的“脏属性”被意外保存，请使用Model::where()->update([])这种查询构建器方式。
- 模型实例同步： 使用查询构建器更新数据库后，如果你的代码仍然依赖于原始的模型实例，请务必手动更新或刷新该实例，以确保其数据与数据库保持一致。
通过掌握这些Eloquent update()方法的细微之处，你可以更精确地控制数据持久化行为，避免潜在的意外更新，从而编写出更健壮、更可预测的Laravel应用。
