Laravel中AJAX上传图片FormData在控制器返回空对象如何解决

首先明确一个常见误区：很多开发者直接通过$request->all()返回的JSON判断文件是否上传成功，实际上Laravel的UploadedFile对象序列化为JSON时会显示为空对象，这并不代表文件没有被正确接收。

步骤1：修复表单属性 #

上传文件的表单必须添加enctype="multipart/form-data"属性，修改你的表单开头：

<form id="category_add" method="#" enctype="multipart/form-data">

步骤2：验证文件是否被正常接收 #

替换控制器开头的返回代码，用Laravel专用的文件判断方法验证接收状态：

// 临时测试代码，排查完成后可删除
if ($request->hasFile('image')) {
    return response()->json([
        'status' => 'success',
        'file_name' => $request->file('image')->getClientOriginalName(),
        'file_size' => $request->file('image')->getSize()
    ]);
} else {
    return response()->json(['status' => 'fail', 'message' => '未接收到图片文件']);
}

如果返回成功且能拿到正确的文件名、大小，说明前端传输完全正常，问题出在后续的接口调用逻辑。

步骤3：修复HTTP客户端上传逻辑 #

Laravel的Http客户端上传文件不能直接将文件对象放到POST参数数组中，必须使用attach()方法挂载文件，修改你调用第三方接口的代码：

if ($request->hasFile('image')) {
    $image = $request->file('image');
    $apiResponse = Http::withHeaders([
        'Authorization' => 'Token ' . $token
    ])
    // 挂载上传文件
    ->attach(
        'c_image', // 第三方接口要求的文件字段名
        file_get_contents($image->getPathname()), // 读取文件内容
        $image->getClientOriginalName(), // 保留原始文件名
        ['Content-Type' => $image->getMimeType()] // 正确设置文件MIME类型
    )
    ->post($url, [
        'data' => [
            'name' => $data['name'],
            'status' => $data['status'],
            'position' => $data['position'],
            'description' => $data['description'],
            'encrypted' => false
        ],
        "encoded_data" => "yes",
    ]);
}

步骤4：优化前端代码（可选） #

你使用new FormData(this)已经会自动收集表单内名为image的文件字段，不需要额外手动appendc_image字段，可以删除这段冗余代码：

// 可删除冗余代码
formData.append('c_image', $('#c_image')[0].files[0]);

其他可能的排查点 #

• 检查php.ini配置中的upload_max_filesize和post_max_size，确保配置值大于你上传的图片大小，修改后需重启服务生效
• 给图片添加验证规则，方便快速定位问题：在验证规则中添加'image' => 'required|image|max:2048'（限制最大2M的图片文件）
• 检查Laravel storage目录的读写权限，确保程序有写入文件的权限

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