Laravel集成AWS S3存储报错：League\Flysystem\UnableToWriteFile

问题描述 #

本地服务器部署的Laravel项目，已按教程完成AWS IAM权限配置及S3存储桶创建，但通过API上传图片时触发报错：

League\Flysystem\UnableToWriteFile: Unable to write file at location

尝试过修改上传逻辑、重新走配置流程等操作，问题仍未解决，请求技术支持。

相关配置信息 #

1. 完整报错栈 #

// 请粘贴完整报错栈内容

2. config/filesystem.php S3配置段 #

// 请粘贴filesystem.php中s3磁盘的配置代码

3. .env 环境变量（隐藏敏感信息） #

// 请粘贴S3相关的.env配置项，如AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY等

4. 控制器上传代码片段 #

// 请粘贴处理图片上传的控制器代码

5. S3存储桶Policy配置 #

// 请粘贴存储桶的Policy JSON内容

6. S3存储桶CORS配置 #

// 请粘贴存储桶的CORS JSON内容

排查与解决步骤 #

1. 验证IAM权限有效性

   • 确认IAM用户拥有s3:PutObject、s3:GetObject、s3:ListBucket权限，且Policy资源路径覆盖桶本身（arn:aws:s3:::your-bucket）及桶内所有对象（arn:aws:s3:::your-bucket/*）
   • 使用AWS IAM控制台的「模拟策略」功能，直接测试该用户是否能执行s3:PutObject操作

2. 检查存储桶公有访问设置

   • 进入S3存储桶「权限」页面，确认「阻止公有访问」配置：若为私有桶，确保仅依赖IAM权限；若需公开访问，需调整对应设置并更新Policy

3. 确认Laravel配置生效

   • 核对.env中AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION、AWS_BUCKET的拼写、大小写及值的正确性，无多余空格
   • 执行php artisan config:clear清除配置缓存，避免旧配置残留
   • 临时添加测试代码验证S3连接：

     use Illuminate\Support\Facades\Storage;
     // 尝试列出桶内文件，测试基础连接
     dd(Storage::disk('s3')->files());
     

4. 排查文件路径与命名问题

   • 确保上传时指定的存储路径未超出Policy限制的范围，避免使用特殊字符
   • 检查文件名是否包含AWS S3禁用字符（如\、{、}、^等）

5. 验证网络与区域连通性

   • 在本地服务器执行curl命令测试S3端点连通性：

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

   • 若服务器在VPC内，需确认VPC端点或安全组规则允许出站访问S3服务

6. 检查依赖版本兼容性

   • 通过composer show league/flysystem-aws-s3-v3查看Flysystem S3适配器版本，确认其与当前Laravel版本兼容，必要时更新或回退对应依赖包

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