Laravel使用AWS S3上传图片失败，报Key长度为0的参数错误

错误根源 #

你触发的InvalidArgumentException提示[Key]预期字符串长度≥1，实际为0，本质是因为Storage::disk('s3')->put()上传失败返回了false，后续调用Storage::disk('s3')->url($path)时传入的$path是false，导致S3执行GetObject操作时使用了空Key，触发验证错误。

上传失败的核心原因是：你调用put方法时仅传入了文件夹名作为第一个参数，没有指定具体的文件名，S3无法确定要存储的对象键。

修复方法 #

方法1：使用putFile自动处理文件名（推荐） #

Laravel的putFile方法会自动生成唯一文件名，简化上传流程：

if ($request->hasFile('image')) {
    $uploadFolder = 'category';
    $image = $request->file('image');

    // putFile会自动生成唯一文件名，返回完整的S3对象键
    $path = Storage::disk('s3')->putFile($uploadFolder, $image, 'public');

    $category->image = Storage::disk('s3')->url($path);
}

方法2：手动指定自定义文件名 #

如果需要自定义文件名（比如用分类slug命名），可以手动拼接完整路径：

if ($request->hasFile('image')) {
    $uploadFolder = 'category';
    $image = $request->file('image');
    
    // 自定义文件名，示例：用分类slug + 原文件扩展名
    $fileName = $category->slug . '.' . $image->getClientOriginalExtension();
    $fullPath = $uploadFolder . '/' . $fileName;

    // 传入完整路径和文件内容执行上传
    $uploadSuccess = Storage::disk('s3')->put($fullPath, file_get_contents($image), 'public');
    
    if ($uploadSuccess) {
        $category->image = Storage::disk('s3')->url($fullPath);
    }
}

额外排查点 #

• 确认.env中的S3配置正确：AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION、AWS_BUCKET必须填写无误。
• 检查S3存储桶的IAM权限，确保当前用户拥有s3:PutObject权限。
• 可以添加文件有效性检查，避免无效文件上传：

  if ($request->hasFile('image') && $request->file('image')->isValid()) {
      // 执行上传逻辑
  }
  

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