本文详解 Laravel 中因误用查询构造器导致更新失效的问题，指出应直接调用已绑定模型实例的 update() 方法，而非重复使用 where() 查询，避免绕过模型事件、访问器及批量赋值保护机制。
本文详解 laravel 中因误用查询构造器导致更新失效的问题，指出应直接调用已绑定模型实例的 `update()` 方法，而非重复使用 `where()` 查询，避免绕过模型事件、访问器及批量赋值保护机制。
在 Laravel 开发中，使用路由模型绑定（Route Model Binding）配合 update() 方法是更新资源的标准实践。但许多开发者会不自觉地写成：
Stationery::where('id', $stationery->id)->update($validated);这段代码看似逻辑正确，实则存在根本性缺陷：它跳过了 Eloquent 模型的生命周期，直接调用查询构造器执行 SQL UPDATE，导致以下关键功能全部失效：
- ✅ 模型的 updating / updated 事件不会触发
- ✅ 访问器（Accessors）、修改器（Mutators）不会生效（例如自动格式化价格、清理字段）
- ✅ $fillable 或 $guarded 的批量赋值保护虽未报错，但绕过了模型层面的属性过滤逻辑（尤其当 $guarded = ['id'] 时，仍可能意外写入非预期字段）
- ✅ 模型观察者（Observers）完全不响应
- ✅ 时间戳（updated_at）不会自动更新（除非显式设置，而 Eloquent 实例默认会处理）
✅ 正确做法是直接复用由路由自动解析的 Eloquent 模型实例：
public function update(Request $request, Stationery $stationery)
{
$validated = $request->validate([
'category_id' => 'required|exists:categories,id',
'nama' => 'required|string|max:255',
'satuan' => 'nullable|string|max:50',
'harga' => 'required|numeric|min:0',
'keterangan' => 'nullable|string'
]);
// ✅ 正确：调用模型实例的 update()，触发完整 Eloquent 生命周期
$stationery->update($validated);
return redirect('/barang/pakaihabis')->with('success', 'Data Berhasil Diubah!!');
}? 提示：$stationery 是已从数据库加载的完整模型对象，其 update() 方法会自动处理时间戳、事件分发、属性同步等，并确保仅更新 $fillable 白名单字段（或排除 $guarded 字段），安全且语义清晰。
? 额外建议与注意事项：
- 若需自定义更新前逻辑（如日志记录、权限校验），可在 update() 前添加业务代码，或使用模型事件；
- 验证规则中建议补充 exists 约束（如 category_id 必须存在于 categories 表），提升数据一致性；
- 如遇更新后 updated_at 未变化，请检查数据库字段是否为 TIMESTAMP 类型且未启用自动更新（Laravel 默认依赖 PHP 层设置，非数据库自动）；
- 调试时可用 $stationery->isDirty() 判断字段是否实际变更，或 dd($stationery->getChanges()) 查看被修改的属性。
遵循这一模式，不仅能修复“数据不更新”的表象问题，更能保障应用长期可维护性与数据完整性。
