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

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）进行更新操作。

讯飞智作-讯飞配音

讯飞智作是一款集AI配音、虚拟人视频生成、PPT生成视频、虚拟人定制等多功能的AI音视频生产平台。已广泛应用于媒体、教育、短视频等领域。

67

查看详情

通过查询构建器，我们可以精确地指定要更新的记录和字段，而不会受到模型实例上“脏属性”状态的影响。

// 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实例，它的属性值可能与数据库中的实际值不一致。

为了保持模型实例与数据库的同步，你有以下几种选择：

1. 手动更新模型实例： 如果只更新了少量已知字段，可以直接在模型实例上设置这些字段的新值。为了避免这些手动设置的字段在未来再次调用save()时被误认为是“脏”属性并重新保存，可以使用setOriginalAttribute()方法将其标记为原始状态。

   $user->first_name = 'Alex';
   $user->setOriginalAttribute('first_name', 'Alex');

   登录后复制

2. 刷新模型实例： 如果更新的字段较多，或者不确定哪些字段被更新，可以使用$user->refresh()方法从数据库中重新加载该模型的所有属性。这种方法虽然方便，但会产生一次额外的数据库查询。

   $user->refresh(); // 从数据库重新加载所有属性

   登录后复制

总结与最佳实践

• 理解$model->update()： 当通过模型实例调用update()时，它会先填充传入的属性，然后调用save()方法，这会持久化模型实例上所有已修改的“脏”属性。
• 精确更新： 如果你只想更新数据库中特定字段，而不希望任何模型实例上的“脏属性”被意外保存，请使用Model::where()->update([])这种查询构建器方式。
• 模型实例同步： 使用查询构建器更新数据库后，如果你的代码仍然依赖于原始的模型实例，请务必手动更新或刷新该实例，以确保其数据与数据库保持一致。

通过掌握这些Eloquent update()方法的细微之处，你可以更精确地控制数据持久化行为，避免潜在的意外更新，从而编写出更健壮、更可预测的Laravel应用。

以上就是深入理解Eloquent update()行为：避免意外更新脏数据的详细内容，更多请关注php中文网其它相关文章！