深入理解 Eloquent update()：如何避免意外的“脏”属性更新

本文深入探讨了 Eloquent ORM 中 update() 方法的一个常见行为：当通过模型实例调用 update() 并传入特定字段时，模型上预先修改但未保存的“脏”属性也可能被一同持久化。文章将解析此行为的底层原因，并提供一种精确更新指定字段、同时忽略其他“脏”属性的解决方案，即通过静态查询 where()->update() 来实现，并指导如何同步模型实例状态。

Eloquent update() 方法的行为解析

在使用 eloquent orm 进行数据更新时，开发者常会遇到一个行为上的细微之处：通过模型实例调用 update() 方法时，除了传入的特定字段外，模型实例上所有在当前操作前被修改但尚未保存的“脏”属性也会被一同持久化到数据库。

这一行为的根源在于 Eloquent Model 类的 update() 方法的内部实现。根据其源代码定义，update() 方法实际上是在当前模型实例上先调用 fill() 方法填充传入的属性，然后紧接着调用 save() 方法。save() 方法的职责是将模型实例上所有被修改过的属性（即“脏”属性）写入数据库。

考虑以下代码示例：

$user = User::find(1);
// 修改了 is_admin 属性，使其成为“脏”属性
$user->is_admin = 1;
// 调用 update() 方法更新 first_name
$user->update(['first_name' => 'Alex']);
// 此时，数据库中的 user 记录的 is_admin 字段也会被更新为 1，
// 而不仅仅是 first_name 字段。

在这个例子中，$user->is_admin = 1; 操作使得 $user 实例的 is_admin 属性变为“脏”属性。当随后的 $user->update([‘first_name’ => ‘Alex’]); 被执行时，它会先将 first_name 填充到模型，然后由于内部调用了 save()，所有在 $user 实例上被标记为“脏”的属性（包括 is_admin）都会被一同保存到数据库。这可能与开发者的预期——只更新 first_name——不符。

精确更新指定字段的策略

为了实现只更新指定字段，同时完全忽略模型实例上其他“脏”属性的目的，我们应该避免使用模型实例的 update() 方法，而是采用静态查询的方式直接对数据库进行更新操作。

推荐的解决方案是利用 Eloquent 模型的 where() 和 update() 静态方法组合：

$user = User::find(1);
// 假设我们仍然在实例上修改了 is_admin，使其变为“脏”属性
$user->is_admin = 1;
// 使用静态查询方式更新，只指定要更新的字段。
// 这种方式不会考虑 $user 实例的任何“脏”属性。
User::whereKey($user->getKey())->update(['first_name' => 'Alex']);
// 重要提示：上述静态更新操作不会自动同步内存中的 $user 实例的状态。
// 如果你后续仍需使用 $user 实例，你需要手动更新其属性以反映数据库中的最新状态。
$user->first_name = 'Alex'; // 手动更新实例的 first_name 属性
// 此时 $user->is_admin 仍然是 1（内存中的脏值），但数据库中 is_admin 未被触及。
// 如果需要 $user 实例完全反映数据库状态，可以调用 $user->refresh();
// 但 refresh() 会产生额外的数据库查询，这与本教程避免额外查询的初衷相悖，
// 因此通常只在确实需要完全同步时使用。

通过 User::whereKey($user->getKey())->update([‘first_name’ => ‘Alex’]); 这种方式，我们直接向数据库发送了一个 UPDATE 语句，该语句仅针对 first_name 字段进行修改，并且完全独立于 $user 模型实例在内存中的任何“脏”状态。这确保了更新的精确性。

关于 syncOriginal() 方法的说明

在某些情况下，你可能会遇到 syncOriginal() 方法。该方法的作用是将模型的所有属性重置为其“原始”状态（即从数据库加载时的状态，或上次 save()/refresh() 后的状态）。虽然 syncOriginal() 可以用于在保存前放弃模型上的所有未保存更改，但它并不能解决本教程中描述的问题。一旦模型实例的 update() 方法被调用并执行了内部的 save()，脏属性就已经被持久化到数据库。此时再调用 syncOriginal()，模型将从数据库中同步新的（包含意外更新的）状态，而非回滚。因此，syncOriginal() 不适用于在 update() 之后解决此问题。

总结与最佳实践

理解 Eloquent update() 方法在模型实例和静态查询上下文中的不同行为至关重要。

• 使用 $model->update(array $attributes)： 当你希望将模型实例上所有当前“脏”的属性（包括传入数组中的属性）一同保存到数据库时，使用此方法。它本质上是 $model->fill($attributes)->save() 的快捷方式。
• 使用 Model::where()->update(array $attributes)： 当你需要精确地更新数据库中的特定列，并且不希望受到内存中任何模型实例“脏”状态的影响时，应采用此静态查询方式。这种方法会直接执行一个 UPDATE SQL 查询。请记住，使用此方法后，如果你的应用程序继续使用相关的模型实例，你需要手动更新该实例的属性以使其与数据库状态保持一致。

掌握这些区分有助于你更精确地控制数据持久化过程，从而避免在 Eloquent 应用程序中出现意外的副作用。