Laravel+jQuery File Upload报错：Call to a member function store() on array

问题分析 #

你遇到的"Call to a member function store() on array"错误，核心原因是遍历的对象不对。从dd($request->files)的输出能看到，$request->files是一个FileBag实例，它内部的parameters数组里，键"files"对应的才是你上传的文件数组（包含UploadedFile对象）。

当你直接foreach($request->files as $file)时，循环拿到的$file其实是整个"files"对应的数组（也就是你var_dump看到的那个包含单个UploadedFile的数组），而不是单个文件对象，自然调用不了store()方法。

解决方案 #

修改控制器代码，正确获取并遍历上传的文件数组即可，这里提供两种常用方式：

方式一：通过$request->file()方法直接获取（推荐）

public function upload(Request $request) {
    // 获取表单name="files[]"对应的上传文件数组
    $uploadedFiles = $request->file('files');
    
    // 遍历单个文件对象
    foreach($uploadedFiles as $file) {
        // 先判断文件是否上传有效，避免报错
        if ($file->isValid()) {
            $filename = $file->store('library');
            // 这里可以收集文件名或做其他业务处理
        }
    }

    // 返回前端需要的JSON响应
    return response()->json([
        'status' => 1,
        'msg' => '文件上传成功'
    ]);
}

方式二：从FileBag中取出文件数组

如果你一定要操作$request->files，可以用get()方法取出对应键的数组：

public function upload(Request $request) {
    // 从FileBag中取出名为"files"的文件数组
    $filesArray = $request->files->get('files');
    
    foreach($filesArray as $file) {
        if ($file->isValid()) {
            $filename = $file->store('library');
        }
    }

    return response()->json(['status' => 1, 'msg' => '上传完成']);
}

额外建议 #

1. 始终加上$file->isValid()判断，能过滤掉上传过程中出错的文件（比如文件过大、临时文件丢失等情况）。
2. 前端代码里的fileuploadadd事件中，当前只判断了第一个文件（data.originalFiles[0]），如果用户上传多个文件，这个校验会失效，建议遍历data.originalFiles逐个校验。

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