Flutter中使用gcloud.storage如何将云存储文件设置为公开访问？

方案1：上传时单独设置单文件公开权限 #

适合仅部分上传文件需要公开访问的场景，上传时直接指定权限即可，以官方googleapis库的storage_v1接口为例：

• 核心配置是调用objects.insert方法时传入predefinedAcl: 'publicRead'参数，上传完成后文件自动获得公开访问权限，示例代码如下：

import 'dart:io';
import 'package:googleapis/storage/v1.dart';
import 'package:googleapis_auth/googleapis_auth.dart';

Future<String> uploadPublicGcsFile(
  AuthClient authClient,
  String bucketName,
  String localFilePath,
  String remoteObjectName,
) async {
  final storageApi = StorageApi(authClient);
  final targetFile = File(localFilePath);
  final uploadMedia = Media(targetFile.openRead(), targetFile.lengthSync());

  await storageApi.objects.insert(
    StorageObject(name: remoteObjectName),
    bucketName,
    uploadMedia: uploadMedia,
    // 关键配置：指定文件权限为公开读
    predefinedAcl: 'publicRead',
  );

  // 固定格式的公开访问链接
  return 'https://storage.googleapis.com/$bucketName/$remoteObjectName';
}

• 如果你使用的是第三方封装的GCS操作库，大部分都支持直接传公开参数，比如flutter_gcloud_storage库只需在上传方法中加public: true参数即可：
  await flutterGCloudStorage.uploadFile(bucketName: "your_bucket", filePath: "local/file/path", destination: "remote/object/path", public: true);

方案2：设置存储桶全局默认公开权限 #

如果业务场景要求该存储桶内所有文件都公开访问，可以直接配置桶级默认权限，后续上传的所有文件自动继承公开属性，无需每次上传单独配置：

• 打开Google Cloud控制台，进入Cloud Storage服务页，找到目标存储桶
• 进入「权限」标签页，点击「授予访问权限」按钮
• 在「新主体」输入框填写allUsers，「角色」下拉选择「存储对象查看者」
• 保存配置后生效，该桶内所有新上传、已上传的文件都默认支持公开访问

注意：设置存储桶全局公开后，所有文件都可以被任何人无权限访问，请勿在该桶存储敏感类数据。如果需要部分文件私有，可在上传时单独指定私有权限覆盖默认配置。

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