上传提示成功但AWS S3桶无文件存储问题求助

1. 验证配置有效性 #

• 检查 .env 中 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION、AWS_BUCKET 四个变量，确保无多余空格、拼写错误，区域与桶实际区域完全一致（如 ap-southeast-1 不能简写）
• 执行 php artisan config:clear 清除配置缓存，避免旧配置残留
• 临时打印配置确认：dd(config('filesystems.disks.s3'))，确保读取的是最新的 .env 值

2. 检查 IAM 权限 #

• 确保 AWS 访问用户拥有 S3 桶的写入权限，最小权限策略需包含：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:PutObject", "s3:PutObjectAcl"],
            "Resource": "arn:aws:s3:::你的桶名/*"
        }
    ]
}

• 若权限不足，CloudTrail 会记录拒绝事件，可在 AWS 控制台查看

3. 排查文件与路径问题 #

• 确认上传的 $file 是有效对象：dd($file->isValid())，必须返回 true
• 检查 $filePath 是否合法，S3 路径不需要前缀斜杠，避免特殊字符
• 替换 file_get_contents($file) 为 Laravel 自带方法：$file->getContent()，避免文件读取异常
• 用固定路径测试：Storage::disk('s3')->put('test.jpg', $file->getContent())，排除路径拼接错误

4. 查看日志定位错误 #

• 查看 Laravel 日志文件 storage/logs/laravel.log，搜索 s3 或 PutObject 关键词，获取具体错误信息
• 登录 AWS CloudTrail 控制台，筛选对应时间的 PutObject 请求，查看是否有权限拒绝、区域不匹配等报错

5. 测试基础连接 #

• 执行 Storage::disk('s3')->exists('dummy.txt')，返回 true 说明桶连接正常
• 尝试上传简单文本：Storage::disk('s3')->put('dummy.txt', 'test content')，若失败，错误信息更易排查

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