Laravel 9无法连接AWS S3存储桶问题排查求助

问题概述 #

配置Laravel API上传图片至AWS S3存储桶时遇到以下问题：

• 已完成.env和filesystems.php的S3参数配置
• 成功安装league/flysystem-aws-s3-v3 ^3.0扩展包
• 执行$request->file('filename')->storeAs($directory, $imgName, 's3')无报错，但文件未上传至S3
• 检查S3中手动上传的文件存在性时，抛出League\Flysystem\UnableToCheckDirectoryExistence异常
• AWS IAM控制台显示使用的访问密钥从未被调用过

排查与解决步骤 #

1. 确认配置是否生效 #

• 执行php artisan config:clear清除Laravel配置缓存，避免加载旧配置
• 临时在代码中打印配置值，验证是否正确读取：

  dd(env('AWS_ACCESS_KEY_ID'), env('AWS_BUCKET'), env('AWS_DEFAULT_REGION'));
  

2. 检查IAM用户权限 #

• 确保IAM用户拥有S3读写权限，建议配置以下最小权限：

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "s3:PutObject",
                  "s3:GetObject",
                  "s3:ListBucket",
                  "s3:DeleteObject"
              ],
              "Resource": [
                  "arn:aws:s3:::your-bucket-name/*",
                  "arn:aws:s3:::your-bucket-name"
              ]
          }
      ]
  }
  

• 核对.env中的AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY，确保无输入错误或多余空格

3. 修正区域与端点配置 #

• 针对me-south-1（中东巴林区域），需显式设置端点：

  AWS_ENDPOINT=https://s3.me-south-1.amazonaws.com
  

• 若存储桶名称包含点号，将AWS_USE_PATH_STYLE_ENDPOINT设为true

4. 开启错误调试 #

• 修改filesystems.php中S3配置的'throw' => true，强制抛出具体错误信息
• 使用try-catch包裹存储代码，捕获详细异常：

  try {
      $path = $request->file('filename')->storeAs($directory, $imgName, 's3');
      dd($path);
  } catch (\Exception $e) {
      dd($e->getMessage(), $e->getTraceAsString());
  }
  

5. 验证文件上传逻辑 #

• 确认请求中存在上传文件：

  if (!$request->hasFile('filename')) {
      dd('未获取到上传文件');
  }
  

• S3无需提前创建目录，$directory仅作为文件键的一部分，确保格式合法

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