Laravel 10+Inertia更新个人资料时必填字段验证异常问题

问题根源 #

上传文件时，表单数据需以multipart/form-data格式提交，但Inertia默认的patch请求不会自动转换为该格式，导致name、email等文本字段无法被后端正确接收，进而触发必填字段的验证错误。

解决方案 #

1. 修正Vue组件的请求参数 #

在表单提交时，给form.patch添加forceFormData: true参数，强制Inertia将所有表单数据打包为FormData，确保文件和文本字段都能正确传递到后端：

<!-- 修改form的submit事件 -->
<form @submit.prevent="form.patch(route('profile.update'), { forceFormData: true })" class="mt-6 space-y-4" >

2. 调整验证规则（可选） #

如果头像并非必填项，将ProfileUpdateRequest中的profile_picture规则改为可选，并添加上传校验规则：

public function rules()
{
    return [
        'name' => ['required', 'string', 'max:255'],
        'email' => ['required', 'email', 'string', 'max:255', Rule::unique('users')->ignore(Auth::user())],
        'password' => ['nullable', 'string', 'confirmed', 'min:8'],
        'profile_picture' => ['nullable', 'file', 'image', 'max:2048'], // 限制为图片类型，最大2MB
    ];
}

3. 简化文件上传逻辑（可选） #

使用Laravel内置的文件存储方法简化代码：

if ($request->hasFile('profile_picture')) {
    $filename = $request->file('profile_picture')->store('profile_pictures', 'public');
    $request->user()->profile_picture = basename($filename);
}

修改完成后，上传头像时文本字段会正常提交，不会再触发不必要的必填验证错误。

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