Laravel上传多图至S3报错：call to a member function extension() on array

核心问题 #

生产环境中，$request->file('subcatagories_template')返回的数组里存在非UploadedFile的元素，导致调用getClientOriginalName()时触发错误。本地环境正常是因为请求参数解析正确，每个元素都是合法的上传文件实例。

修复步骤 #

1. 增加文件实例校验 #

在循环前先确保拿到的是数组，并且每个元素都是UploadedFile，避免无效数据进入逻辑：

$uploadedImages = [];
$images = $request->file('subcatagories_template');

// 统一处理单图/多图的情况，确保是数组格式
if (!is_array($images)) {
    $images = [$images];
}

foreach ($images as $key => $image) {
    // 跳过非上传文件的无效元素
    if (!$image instanceof \Illuminate\Http\UploadedFile) {
        continue;
    }

    // 改用Laravel内置的extension()方法获取后缀，更可靠
    $filename = uniqid() . '.' . $image->extension();
    
    $resizedImage = Image::make($image)->encode();
    $subcategory_id = $subcategory->id;
    $realPath = 'subcategoriesTemplate/' . $subcategory_id;

    if (!Storage::disk('s3')->exists($realPath)) {
        Storage::disk('s3')->makeDirectory($realPath);
    }

    Storage::disk('s3')->put($realPath . '/' . $filename, $resizedImage->__toString(), 'public');
    $subcategory_templateUrl = Storage::disk('s3')->url($realPath . '/' . $filename);

    $uploadedImages[] = [
        'path' => $subcategory_templateUrl,
    ];
}

2. 确认前端请求格式 #

• 确保API请求的Content-Type设置为multipart/form-data
• 多图上传的参数名必须带[]，即subcatagories_template[]，这样Laravel才能正确解析为上传文件数组

3. 额外优化点 #

• 代码中subcatagories_template存在拼写错误（应为subcategories_template），如果前端参数名是正确的，需要同步修正代码中的参数名，避免后续出现隐性问题
• 可以增加请求参数验证，在控制器方法开头添加：

$this->validate($request, [
    'subcatagories_template.*' => 'image|mimes:jpeg,png,jpg,gif|max:2048',
]);

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