Laravel更新登录用户字段:为何save()可用而update()无效?
失效核心原因
Auth::user()->update() 无法生效、但单独赋值后调用save()可以正常写入的本质差异,来自Laravel模型的批量赋值保护机制,和Auth认证模块本身没有直接关联:
- 模型的
update()方法底层执行逻辑:先通过fill()方法把传入的关联数组同步到模型属性,再调用save()落库。其中fill()会做严格的批量赋值校验,只有字段在模型定义的$fillable白名单内(或不在$guarded黑名单内)时,才会被真正同步到模型属性,不符合规则的字段会被静默丢弃,不抛任何报错。 - 你直接写
Auth::user()->the_field = $theField的赋值操作,是完全绕过批量赋值校验的——不管字段是否在白名单中,属性都会被正常写入到模型实例上,后续执行save()自然能把字段同步到数据库。
补充说明:很多开发者会误以为Auth::user()返回的是和普通模型实例不同的特殊代理对象,实际上它和你通过User::find(auth()->id())查询得到的模型实例完全一致,所有模型方法的行为没有任何区别,不存在Auth模块单独对update方法做拦截的情况。
为什么订单模型的update逻辑运行正常
你在编写订单相关代码时,大概率已经把order_status字段加入了Order模型的$fillable白名单,批量赋值校验直接放行,所以$order->update()可以正常写入数据。
而Laravel框架默认生成的User模型,初始化时的$fillable仅包含name、email、password三个字段,你自定义的the_field没有主动加入可批量赋值列表的话,调用update()时传入的这个字段会被fill()直接过滤,最终等同于对一个无变更的空模型执行save,自然看不到任何更新效果。
修复与排查步骤
- 首选方案:打开
app/Models/User.php文件,把需要支持批量赋值更新的自定义字段加入$fillable数组,示例代码:
protected $fillable = [ 'name', 'email', 'password', 'the_field', // 新增需要通过update()批量更新的字段 ];
- 非必要不推荐的方案:你可以把User模型的
$guarded属性设置为[],直接放开所有字段的批量赋值限制,但这种写法会大幅提升批量赋值漏洞的风险,生产环境使用需要配合严格的前端字段校验。 - 额外排查点:如果调整完$fillable后问题依旧,检查是否自定义了Auth guard的用户返回逻辑,或是在User模型中对自定义字段做了拦截修改(比如通过类型转换、修改器逻辑对字段值做了无效转换)。
内容的提问来源于stack exchange,提问作者padawanTony
相关产品推荐
相关产品推荐

