Laravel 8 使用S3 Storage存储图片后Blade页面无法正常获取展示问题

问题1：路径报错/斜杠丢失原因 #

你调用的Storage::disk('s3')->response()方法接收的参数是S3 bucket内的相对路径（比如coverimgs/xyz.png），而你存入$project->coverimg的是完整的S3访问URL，传入完整URL会被Laravel识别为相对路径做拼接，最终出现路径解析错误、斜杠丢失的问题。

修复方案 #

前端直接输出你已经存好的完整URL即可，修改Blade代码为：

src="{{ $project->coverimg }}"

如果你不想存完整URL，只存相对路径的话，前端可以这么写：

src="{{ Storage::disk('s3')->url($project->coverimg) }}"

问题2：S3文件未设置为公开访问原因 #

你可以按以下顺序排查配置疏漏：

• 检查config/filesystems.php中s3磁盘的配置，确认是否添加了默认公开配置：

's3' => [
    'driver' => 's3',
    'key' => env('AWS_ACCESS_KEY_ID'),
    'secret' => env('AWS_SECRET_ACCESS_KEY'),
    'region' => env('AWS_DEFAULT_REGION'),
    'bucket' => env('AWS_BUCKET'),
    'url' => env('AWS_URL'),
    'visibility' => 'public', // 缺失这行会导致默认权限为私有，单次setVisibility可能不生效
],

• 登录AWS S3控制台，进入对应bucket的「权限」选项卡，检查「阻止公共访问(存储桶设置)」是否开启了全局阻止，需要关闭允许公共ACL的选项。
• 检查对接S3所用的IAM用户权限，确认是否添加了s3:PutObjectAcl权限，没有该权限的话代码中调用setVisibility会静默失败，无法修改文件的公开属性。
• 确认bucket是否配置了允许公开读的桶策略，参考配置如下（替换为你自己的bucket名）：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "PublicReadGetObject",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::你的bucket名称/*"
        }
    ]
}

可选无公开访问方案 #

如果你不想将bucket设置为公开访问，可以生成临时签名URL供前端访问，无需修改bucket权限：

// 存文件时只存相对路径，不要存完整URL
$project->coverimg = $path;
// 前端输出时生成10分钟有效期的临时链接
src="{{ Storage::disk('s3')->temporaryUrl($project->coverimg, now()->addMinutes(10)) }}"

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