Laravel部署服务器后API调用Storage::disk('s3')->put()上传失败

问题回顾 #

本地环境使用Storage::disk('s3')->put()上传文件正常，但部署到服务器后API调用返回500空响应，仅HTML表单调用正常，代码执行到put()方法时静默终止，try-catch无法捕获错误。

排查与修复步骤 #

1. 检查PHP配置限制

服务器端PHP的上传/内存限制可能导致大文件上传失败：

• 执行命令查看当前配置：

  php -i | grep -E "post_max_size|upload_max_filesize|memory_limit"
  

• 修改php.ini（或对应环境的配置文件），调整以下参数：

  post_max_size = 64M
  upload_max_filesize = 64M
  memory_limit = 256M
  

• 重启web服务（如Nginx/Apache）和PHP-FPM。

2. 验证AWS配置与权限

• 确认服务器端.env文件的AWS配置项与本地一致：

  AWS_ACCESS_KEY_ID=your-key-id
  AWS_SECRET_ACCESS_KEY=your-secret-key
  AWS_DEFAULT_REGION=your-region
  AWS_BUCKET=your-bucket-name
  AWS_URL=https://your-bucket.s3.your-region.amazonaws.com
  

• 避免在代码中直接使用env()函数，改用配置文件读取：

  // 替换空的$bucket变量
  $bucket = config('filesystems.disks.s3.bucket');
  

• 检查IAM用户权限，确保包含s3:PutObject、s3:PutObjectAcl等必要权限。

3. 修复异常捕获逻辑

当前try-catch仅捕获Exception，无法覆盖致命错误或第三方库异常：

• 将捕获范围改为\Throwable，并添加日志记录：

  catch (\Throwable $ex) {
      \Log::error('S3上传失败', [
          'message' => $ex->getMessage(),
          'trace' => $ex->getTraceAsString()
      ]);
      return ResponseHelpers::serverErrorResponse($ex->getMessage(), '');
  }
  

• 查看storage/logs/laravel.log获取详细错误信息。

4. 优化文件上传方式

使用file_get_contents()会将整个文件加载到内存，易引发内存溢出，改用文件流上传：

// 非图片文件上传
$upload = Storage::disk('s3')->put($uploadDir, fopen($file->getRealPath(), 'r'));

// 图片文件上传优化
$image = \Image::make($file->getRealPath());
$upload = Storage::disk('s3')->put($uploadDir, $image->encode('jpeg', 50), 'public');

5. 修复代码逻辑错误

当前图片判断逻辑错误，误将文件名前缀当作扩展名判断：

// 替换原错误判断
if (in_array($extent, ['jpg', 'jpeg', 'png'])) {
    // 图片处理逻辑
}

6. 检查服务器网络连通性

• 测试服务器到S3端点的连通性：

  curl -v https://your-bucket-name.s3.your-region.amazonaws.com
  

• 确认服务器安全组/防火墙未限制出站HTTPS流量（443端口）。

内容的提问来源于stack exchange，提问作者Khả Nam