如何用Python SDK将GCP存储桶接入Firestore？Flutter上传自定义桶遇错

一、通过Python SDK将自定义GCP桶接入Firebase并配置规则 #

自定义GCP桶要被Firebase Storage识别并应用规则，需先关联到Firebase项目，再配置Firebase安全规则，具体步骤如下：

1. 关联现有GCP桶到Firebase项目
   确保自定义桶与Firebase项目同属一个GCP项目，使用Firebase Admin SDK完成关联：

   import firebase_admin
   from firebase_admin import credentials, storage
   
   # 初始化Firebase Admin
   cred = credentials.Certificate('service-account-key.json')
   firebase_admin.initialize_app(cred, {
       'storageBucket': 'your-default-bucket.appspot.com'  # 项目默认桶，用于初始化
   })
   
   # 标记自定义桶为Firebase管理的存储桶
   bucket = storage.bucket('your-custom-bucket-name')
   bucket.patch({'labels': {'firebase-storage': 'enabled'}})
   

2. 配置Firebase安全规则
   关联完成后，可通过Firebase Admin SDK直接更新自定义桶的安全规则：

   # 示例规则：允许认证用户上传，所有人可读
   rules_content = """
   rules_version = '2';
   service firebase.storage {
     match /b/{bucket}/o {
       match /{allPaths=**} {
         allow write: if request.auth != null;
         allow read: if true;
       }
     }
   }
   """
   
   # 更新自定义桶的规则
   storage_client = storage.Client()
   bucket = storage_client.get_bucket('your-custom-bucket-name')
   bucket.set_firebase_rules(rules_content)
   

   注意：Firebase安全规则仅对通过Firebase Storage SDK发起的请求生效，直接调用GCS API的请求将遵循GCP IAM权限配置。

二、Flutter Web上传GCP桶的替代方案 #

若不想依赖Firebase Storage SDK，可采用以下两种方式：

1. 使用预签名URL（推荐） #

由后端Python微服务生成GCS预签名URL，前端直接通过HTTP请求上传，无需暴露服务账号密钥：

• 后端生成预签名URL的Python代码：

  from google.cloud import storage
  from datetime import timedelta
  
  def generate_upload_signed_url(bucket_name, blob_name):
      storage_client = storage.Client()
      bucket = storage_client.bucket(bucket_name)
      blob = bucket.blob(blob_name)
  
      url = blob.generate_upload_signed_url(
          version="v4",
          expiration=timedelta(minutes=15),  # URL有效期
          method="PUT",
          content_type="application/octet-stream"  # 匹配目标文件类型
      )
      return url
  

• Flutter Web端上传代码：

  final url = '后端返回的预签名URL';
  final response = await http.put(
    Uri.parse(url),
    headers: {'Content-Type': 'application/octet-stream'},
    body: data,
  );
  if (response.statusCode == 200) {
    // 上传成功逻辑
  }
  

2. 直接调用GCS REST API #

通过GCS REST API上传，需前端通过Google Sign-In获取用户OAuth 2.0访问令牌，携带令牌调用API：

final accessToken = '用户OAuth访问令牌';
final url = 'https://storage.googleapis.com/storage/v1/b/your-bucket-name/o?name=$filename';
final response = await http.post(
  Uri.parse(url),
  headers: {
    'Authorization': 'Bearer $accessToken',
    'Content-Type': 'application/octet-stream',
  },
  body: data,
);

注意：需确保用户的OAuth令牌具备devstorage.objects.create权限。

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