如何通过Laravel API让Android应用访问S3存储中的私有文件

每个用户在S3磁盘上存储有若干私有文件（照片、视频等），我通过Android应用向Laravel服务端请求文件列表并展示给用户。目前使用Laravel的资源集合返回文件列表，但存在以下疑问：

1. 客户端如何通过文件路径访问文件本身？
2. 是否需要为每个文件向Laravel发起下载请求？

考虑到文件数量较多，我希望获取列表时直接得到可访问链接，无需逐个请求下载以在应用列表视图中展示。

Laravel端现有代码：

Route::get('api/user/{user}/files', function (User $user){
    $files = $user->files();
    return new FileCollection($files);
});

Route::get('api/download/{path}', function (string $path){
    return Storage::disk('s3')->download($path);
});

解决方案 #

先改Laravel端，直接返回可访问的临时链接 #

S3上的私有文件没法直接用路径打开，得用预签名URL——这是带临时访问权限的链接，生成后一段时间内可以直接访问。你需要修改返回文件列表的资源类，把预签名URL一起返回：

// 对应你的FileCollection里的单个资源类，比如app/Http/Resources/FileResource.php
public function toArray($request)
{
    return [
        'id' => $this->id,
        'name' => $this->name,
        'path' => $this->path,
        // 生成有效期1小时的预签名URL，时间可以按需调整
        'access_url' => Storage::disk('s3')->temporaryUrl(
            $this->path,
            now()->addMinutes(60)
        ),
        // 其他你需要的字段
    ];
}

这样客户端请求文件列表接口时，每个文件项都会带access_url，直接用这个链接就能加载内容，不用再走下载接口。

客户端的具体处理 #

1. 拉取文件列表：调用api/user/{user}/files接口，拿到包含access_url的文件数组。
2. 列表展示：用Android的图片加载库（比如Glide、Coil）直接用access_url加载照片，视频的话用ExoPlayer这类播放器直接播放链接就行，完全不用单独发下载请求。
3. 链接过期处理：如果设置了URL有效期，过期后要么重新拉一次文件列表拿新链接，要么单独加个接口让服务端重新生成单个文件的预签名URL，按需选择就行。

原下载接口的用途 #

原来的api/download/{path}接口可以留着，给用户主动下载文件的场景用（比如长按文件选下载），但列表展示的时候完全用不上，省掉大量请求。

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