使用Inertia表单助手提交含文件的更新表单时Laravel服务器收不到数据

1. 显式开启Multipart表单编码 #

Inertia默认用JSON格式提交数据，但包含文件时必须切换为multipart/form-data编码。在提交patch/put请求时添加multipart: true选项：

patch(route("logs.update", log?.id), {
    multipart: true,
    onError: (e) => console.dir(e)
})

这是核心问题——JSON编码无法处理File对象，导致后端接收不到任何数据。

2. 修正FileList的处理方式 #

前端data中的images是FileList类型（类数组对象），Inertia无法直接序列化该类型。需将其转换为单个File对象：
在文件输入的onChange事件中，设置单个文件而非整个FileList：

const handleImageUpload = (e) => {
    setData('images', e.target.files[0])
}

绑定到输入框：

<input type="file" @change="handleImageUpload" />

3. 后端调试与数据验证 #

• 在控制器中输出原始请求内容，确认数据是否真的未接收：

public function update(Request $request, DayLog $log)
{
    // 查看所有提交数据
    dd($request->all());
    // 检查文件是否存在
    dd($request->hasFile('images'));
}

• 确保路由使用web中间件组（已包含CSRF验证，之前文本能提交大概率没问题，但需确认）。

4. 验证请求方法与Method Spoofing #

在浏览器开发者工具的Network标签中检查：

• 请求的实际方法是否为POST
• 请求头中是否存在X-HTTP-Method-Override: PATCH（或PUT）
• 请求的Content-Type是否为multipart/form-data; boundary=...

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