Laravel项目API开发：Postman中PUT请求无法上传图片问题求助

我之前也碰到过一模一样的问题！Laravel在处理PUT/PATCH请求上传文件的时候确实有个小坑，因为默认情况下，PUT请求不会像POST那样自动解析multipart/form-data格式的数据，下面是我亲测有效的几种解决方法：

方法一：用POST请求模拟PUT/PATCH（最推荐） #

这是Laravel官方支持的方案，操作起来最简单：

• 在Postman里把请求方法改成POST
• 在form-data里新增一个键为_method的字段，值填写PUT（如果是部分更新也可以填PATCH）
• 正常添加你要更新的字段（比如title、name）和文件字段
• 后端的路由依然使用Route::put()或者Route::patch()，Laravel会自动识别这个模拟请求，和真正的PUT请求处理逻辑完全一致

方法二：手动处理PUT请求的文件上传 #

如果你一定要用原生PUT请求，可以在控制器里手动解析上传的文件：

public function update(Request $request, $id)
{
    // 获取常规字段
    $updateData = $request->only(['title', 'name']);
    
    // 手动获取上传的文件（替换成你的实际文件字段名）
    $videoFile = $request->file('video');
    
    if ($videoFile && $videoFile->isValid()) {
        // 执行文件存储逻辑（和POST上传时的代码一致）
        $filePath = $videoFile->store('videos', 'public');
        $updateData['video_path'] = $filePath;
    }
    
    // 更新数据库记录
    YourModel::where('id', $id)->update($updateData);
    
    return response()->json(['status' => 'success', 'message' => '内容更新完成']);
}

注意：这种方式下，Postman里直接选PUT方法，用form-data传字段和文件即可，Postman会自动设置正确的Content-Type请求头，不需要手动修改。

额外排查要点 #

• 确认Postman里的文件字段名和后端接收的字段名完全一致，比如后端用video，前端就不能写成file或者videos
• 可以在控制器里用dd($request->file())打印所有上传的文件，看看是否能正常获取到，排查是前端传输还是后端接收的问题
• 检查项目的文件存储权限，确保storage/app/public目录有写入权限，必要时可以执行php artisan storage:link创建软链接

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