Laravel使用Image Intervention更新用户头像时$user->save未生效问题

核心问题排查&修复 #

1. 模型保存方法调用错误 #

你当前代码中手动给$user->avatar赋值后调用的update()方法不符合Laravel的用法规范：

• update()方法仅接收属性数组参数，适用于批量更新场景
• 手动赋值单个属性的场景下，需要调用save()方法完成数据持久化

2. 模型批量赋值规则拦截 #

Laravel会默认拦截未在$fillable属性中声明的字段更新，需要检查app/Models/User.php文件，确认avatar字段已经加入允许批量赋值的列表：

protected $fillable = [
    'name',
    'email',
    'password',
    'avatar', // 新增此行
];

3. 前置文件上传逻辑未执行 #

先调试确认$request->hasFile('avatar')返回值为true，常见触发原因包括：

• 前端提交表单未添加enctype="multipart/form-data"属性
• 上传文件大小超过php.ini中upload_max_filesize、post_max_size的配置限制
• 前端上传字段名称和代码中读取的avatar不一致

4. 头像保存目录权限异常 #

确认public/images/avatars目录存在，且对Web服务器运行用户有写入权限，Linux环境可以执行以下命令修复权限：
chmod -R 755 public/images && chown -R www-data:www-data public/images #

修正后完整代码 #

public function update_avatar(Request $request)
{
    // 新增文件合法性验证
    $request->validate([
        'avatar' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048',
    ]);

    if($request->hasFile('avatar')) {
        $avatar = $request->file('avatar');
        $filename = time() . '.' . $avatar->getClientOriginalExtension();
        $savePath = public_path('/images/avatars/');
        // 自动创建不存在的目录
        if (!file_exists($savePath)) {
            mkdir($savePath, 0755, true);
        }
        Image::make($avatar)->resize(300, 300)->save($savePath . $filename);

        $user = Auth::user();
        $user->avatar = $filename;
        // 改用save方法保存修改
        $user->save();

        return back()->with('success', '头像更新成功');
    }

    return back()->withErrors(['avatar' => '请上传有效的头像文件']);
}

内容的提问来源于stack exchange，提问作者SilverBullet16