Laravel从AWS S3非公开存储桶下载文件失败问题求助

问题根源 #

你对temporaryUrl的作用确实存在使用误解：

• Storage::disk('s3')->temporaryUrl()返回的是完整的带AWS签名的临时访问URL，已经包含了S3域名、文件路径、签名参数、过期时间等完整信息，直接访问即可获取非公开文件，不需要再传入Storage的下载方法中。
• Storage::disk('s3')->download()方法要求传入的参数是存储桶内的文件相对路径，而非完整URL。你将完整临时URL传入该方法时，S3驱动会把整个URL当做文件路径去存储桶中查找对应对象，自然无法找到，触发报错。

正确实现方案 #

根据使用场景选择以下两种实现方式即可：

场景1：优先推荐：直接使用临时URL下载（不占用服务器带宽） #

不需要调用download方法，直接重定向到生成的临时URL，或者将URL返回给前端自行跳转即可触发下载：

// 先处理你存储的完整S3 URL，提取桶内相对路径
$fullS3Url = $request->file;
$fileRelativePath = ltrim(parse_url($fullS3Url, PHP_URL_PATH), '/');

// 生成临时URL，可选配置强制下载参数，避免浏览器直接预览图片、PDF等文件
$temporaryUrl = Storage::disk('s3')->temporaryUrl(
    $fileRelativePath,
    now()->addMinutes(10),
    ['ResponseContentDisposition' => 'attachment']
);

// 方式1：后端直接重定向到临时URL触发下载
return redirect()->to($temporaryUrl);

// 方式2：将URL返回给前端，由前端触发下载
return response()->json([
    'code' => 0,
    'download_url' => $temporaryUrl
]);

场景2：需要后端代理下载（不推荐，大文件易超时、占用服务器带宽） #

如果业务要求必须经过后端服务返回文件流，不需要调用temporaryUrl，直接将文件相对路径传入download方法即可：

// 同样先提取桶内相对路径
$fullS3Url = $request->file;
$fileRelativePath = ltrim(parse_url($fullS3Url, PHP_URL_PATH), '/');

// 直接触发下载，第二个参数可自定义下载后的文件名
return Storage::disk('s3')->download($fileRelativePath, '自定义文件名');

额外说明 #

你使用的Laravel 8 + league/flysystem-aws-s3-v3 1.0.29版本组合完全支持以上两种用法，不需要调整依赖版本。

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