Laravel 12 + Inertia + React 文件上传功能异常求助

你已经尝试了forceFormData: true但问题依旧，从前后端两个维度逐一排查：

后端排查要点 #

• 路由与请求方法匹配：确认business-setting.update路由为PATCH方法，控制器方法正确接收请求实例：

public function update(Request $request, BusinessSetting $businessSetting)
{
    // 后续处理逻辑
}

• 文件验证规则配置：确保验证规则包含文件类型、大小校验，示例：

$validated = $request->validate([
    'name' => 'required|string',
    // 其他字段规则...
    'logo' => 'nullable|image|mimes:jpeg,png,jpg,gif|max:2048',
]);

• 文件接收与存储逻辑：控制器里正确获取并存储文件，示例：

if ($request->hasFile('logo')) {
    $path = $request->file('logo')->store('business_logos', 'public');
    $businessSetting->update(['logo' => $path]);
}
// 更新其他字段
$businessSetting->update($validated);

• 存储目录权限：检查storage/app/public目录是否具备写入权限，执行chmod -R 755 storage/修复权限问题。

前端排查要点 #

• 确认文件绑定状态：在submit方法中添加日志，验证data.logo是否为有效File对象：

const submit: FormEventHandler = (e) => {
    e.preventDefault();
    console.log(data.logo); // 确认输出为File类型数据
    patch(route('business-setting.update', businessSetting.id), {
        forceFormData: true,
    });
};

• 补充表单属性：手动给form标签添加enctype="multipart/form-data"，规避隐性编码问题：

<form className="flex flex-col gap-6" onSubmit={submit} enctype="multipart/form-data">

• 版本兼容性检查：确认@inertiajs/react与laravel/inertia版本适配Laravel 12，建议升级至最新稳定版。

调试技巧 #

打开浏览器开发者工具Network面板，查看PATCH请求详情：

• 检查FormData中是否包含logo字段及对应文件信息
• 查看响应状态码与返回内容，定位后端验证错误或异常信息

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