本文详解 laravel 中因误用 update() 静态方法导致数据未实际更新的问题，指出应优先调用已绑定模型实例的动态 update() 方法，并解释其与静态批量更新的本质区别。
本文详解 laravel 中因误用 update() 静态方法导致数据未实际更新的问题，指出应优先调用已绑定模型实例的动态 update() 方法，并解释其与静态批量更新的本质区别。
在 Laravel 开发中，使用路由模型绑定（Route Model Binding）进行资源更新时，一个常见却隐蔽的错误是：混淆了 Eloquent 模型实例方法与查询构造器静态方法。正如示例代码所示，开发者试图通过 Stationery::where('id', $stationery->id)->update($validated) 更新单条记录，虽无报错、也跳转成功，但数据库内容却未变更——根本原因在于该写法绕过了模型生命周期（如事件、访问器、强制类型转换、$fillable/$guarded 校验逻辑），且在某些配置下可能因属性不可写而静默失败。
✅ 正确做法：调用绑定模型实例的 update() 方法
由于控制器方法签名中已声明类型提示 Stationery $stationery，Laravel 会自动根据路由参数（如 /barang/pakaihabis/{stationery}）注入对应模型实例。此时应直接对该实例调用 update()：
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',
]);
// ✅ 正确：调用模型实例方法，触发模型事件、访问器、属性赋值等完整流程
$stationery->update($validated);
return redirect('/barang/pakaihabis')->with('success', 'Data Berhasil Diubah!!');
}⚠️ 为什么 Stationery::where(...)->update(...) 不推荐用于单模型更新？
- ❌ 跳过模型逻辑：静态 update() 属于查询构造器操作，不加载模型、不触发 updating/updated 事件，也不执行 setXXXAttribute 访问器或 $casts 类型转换；
- ❌ 绕过属性保护机制：即使模型中定义了 $guarded = ['id']，静态 update() 仍会直接写入所有传入字段，丧失安全边界；
- ❌ 无法利用模型验证与转换：例如 harga 字段若需自动转为整数分（如 15000.5 → 1500050），静态更新将完全忽略此类逻辑；
- ✅ 适用场景：仅推荐用于真正需要“无模型介入”的批量更新（如 Stationery::where('status', 'draft')->update(['status' => 'archived'])）。
? 额外排查建议
若仍遇到更新无效，请依次检查：
- 确认模型中 $guarded 或 $fillable 设置是否允许目标字段（本例中 $guarded = ['id'] 是合理的，表示其余字段均可写）；
- 使用 dd($stationery->getAttributes()) 和 dd($validated) 对比字段名是否完全一致（注意键名大小写、下划线命名一致性）；
- 检查数据库字段类型是否兼容（如 harga 为 INT 但提交了浮点数，可能被截断）；
- 启用查询日志：DB::enableQueryLog(); ... dd(DB::getQueryLog()); 确认 SQL 是否真正执行。
掌握模型实例更新与静态批量更新的语义差异，是写出健壮、可维护 Laravel 应用的关键一步。始终优先信任路由模型绑定提供的实例——它不仅是便捷语法糖，更是通向完整 Eloquent 生态的入口。
