Laravel S3文件上传异常：文件损坏且存储目录错误

你的代码存在两个核心问题，直接导致了当前的异常：

• Storage::disk('s3')->put()的参数顺序完全颠倒，第一个参数应为目标存储路径（含目录和文件名），第二个参数是文件的实际内容/文件实例。你现在把文件名放在第一个参数，把目录字符串'logos/'作为文件内容传入，导致S3把这个字符串存成了根目录下的文件，自然下载后损坏，也没放到指定目录。
• 生成文件名时直接拼接时间戳和原文件名，会出现类似1690000000logo.png的不规范格式，建议添加分隔符避免混乱。

修正后的代码 #

$validated = $request->validate([
    'logo' => ['required', 'file', 'mimes:jpeg,png', 'max:2048'],
]);

...

if($request->hasFile('logo')){
    $file = $request->file('logo');
    // 生成规范文件名：时间戳_原文件名
    $fileName = time() . '_' . $file->getClientOriginalName();
    // 使用Laravel推荐的putFileAs方法上传，自动处理文件内容
    $path = Storage::disk('s3')->putFileAs('logos', $file, $fileName);
    
    // 也可以用put方法手动传递文件内容，效果一致
    // $targetPath = 'logos/' . $fileName;
    // $path = Storage::disk('s3')->put($targetPath, $file->getContent());
    
    if (!$path) {
        dd('Failed to upload logo file.');
    }

    $validated['logo'] = $path;
}
...

关键说明 #

• putFileAs是Laravel专门为文件上传设计的方法，第一个参数指定目标目录（logos/），第二个是请求中的文件实例，第三个是自定义文件名，它会自动完成文件读取、上传到指定目录的操作，无需手动处理文件内容。
• 如果使用put方法，必须确保第二个参数是文件的实际内容（比如$file->getContent()），而不是任意字符串。
• 修正后文件会被正确存储到S3的logos/目录下，且文件内容完整，下载后不会损坏。

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