Laravel 9 上传公共图片至AWS S3时出现参数验证错误

已配置Laravel文件系统指向S3存储桶，存储桶内对象均设为公开。使用storeAs()上传文件一切正常，但调用storePubliclyAs()时触发如下错误：

InvalidArgumentException: Found 1 error while validating the input provided for the GetObject operation:
[Key] expected string length to be >= 1, but found string length of 0 in file /var/www/html/vendor/aws/aws-sdk-php/src/Api/Validator.php on line 65

引发问题的上传代码：

if ($request->hasFile("images")) {
    foreach ($request->file("images") as $i => $image) {
        $path = $image->storePubliclyAs($product->id, "image_$i.{$image->extension()}");
    }
}

排查与解决方案 #

• 检查$product->id是否为空：storeAs()在路径为空时可能自动使用默认目录，但storePubliclyAs()对S3的Key校验更严格。确认$product实例已正确加载，id字段为非空字符串。
• 校验文件名有效性：$image->extension()可能返回空（比如部分无扩展名的上传文件），导致最终生成的Key无效。可以改用原始扩展名或添加兜底逻辑：

  $extension = $image->getClientOriginalExtension() ?: 'png'; // 按需设置兜底扩展名
  $filename = "image_$i.$extension";
  $path = $image->storePubliclyAs($product->id, $filename);
  

• 显式指定存储磁盘：即使.env已配置默认磁盘，显式传入磁盘参数可避免潜在的配置读取异常：

  $path = $image->storePubliclyAs($product->id, "image_$i.{$image->extension()}", 's3');
  

• 改用底层方法实现公开存储：如果storePubliclyAs仍有问题，可使用putFileAs手动设置可见性：

  $path = Storage::disk('s3')->putFileAs(
      $product->id,
      $image,
      "image_$i.{$image->extension()}",
      'public'
  );
  

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