Laravel中S3图片上传返回false但可正常读取，求问题排查

1. 改用Laravel原生文件上传逻辑，避免手动读取文件内容 #

你当前用file_get_contents($image)读取上传文件的方式容易触发异常（比如临时文件权限问题、文件读取失败），Laravel的Storage类原生支持直接传入UploadedFile实例，更稳定可靠：

if ($image = $request->file('featured_image')) {
    // 直接传入文件实例，Laravel会自动处理文件上传
    $path = Storage::disk('s3')->put('uploads/', $image);
    Log::info($path);
}

如果需要保留原文件名，使用putFileAs方法：

$path = Storage::disk('s3')->putFileAs(
    'uploads/',
    $image,
    $image->getClientOriginalName()
);

2. 检查IAM用户的写入权限 #

虽然读取功能正常，但你的AWS IAM用户可能仅配置了读取权限（s3:GetObject），缺少写入权限（s3:PutObject）。登录AWS控制台查看IAM策略，确保包含以下权限：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:PutObject" // 必须添加该写入权限
            ],
            "Resource": "arn:aws:s3:::your-bucket-name/*"
        }
    ]
}

3. 捕获异常查看具体错误信息 #

上传返回false通常是因为错误未被抛出，用try-catch包裹代码，打印详细异常日志：

if ($image = $request->file('featured_image')) {
    try {
        $path = Storage::disk('s3')->put($image->getClientOriginalName(), file_get_contents($image));
        Log::info($path);
    } catch (\Exception $e) {
        Log::error('S3上传失败：' . $e->getMessage());
    }
}

通过日志可以定位具体问题，比如文件大小超出S3限制、临时目录权限不足、AWS区域配置不匹配等。

4. 核对.env中的S3配置细节 #

确认.env文件中的AWS_DEFAULT_REGION与存储桶所在区域完全一致，例如你的存储桶在ap-southeast-2，则配置必须为：

AWS_DEFAULT_REGION=ap-southeast-2

同时检查AWS_BUCKET的名称是否拼写正确。

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