如何使用Django ImageField将文件上传至Google Cloud Storage而非本地

完全不需要把文件存在本地，也不用把二进制数据塞进数据库——Django通过自定义存储后端就能直接把ImageField的文件上传到GCP存储桶，这是生产环境的标准方案，比本地存储或数据库存二进制高效得多。

实现步骤： #

1. 安装依赖包
   用django-storages对接GCP存储，搭配官方的google-cloud-storage：

   pip install django-storages google-cloud-storage
   

2. 配置settings.py
   替换默认的文件存储后端，添加GCP相关配置：

   import os
   from google.oauth2 import service_account
   
   # 替换默认本地存储为GCP存储后端
   DEFAULT_FILE_STORAGE = 'storages.backends.gcloud.GoogleCloudStorage'
   # 你的GCP存储桶名称
   GS_BUCKET_NAME = 'your-bucket-name'
   # 可选：GCP项目ID（如果服务账号密钥已包含可省略）
   GS_PROJECT_ID = 'your-gcp-project-id'
   # 本地开发时指定服务账号密钥文件路径；生产环境可依赖GCP服务账号权限（无需本地文件）
   GS_CREDENTIALS = service_account.Credentials.from_service_account_file(
       os.path.join(BASE_DIR, 'gcp-service-account-key.json')
   )
   # 设置文件为公开可读（如果需要直接访问Logo）
   GS_DEFAULT_ACL = 'publicRead'
   # 配置MEDIA_URL为GCP存储桶的公开访问路径
   MEDIA_URL = f'https://storage.googleapis.com/{GS_BUCKET_NAME}/'
   

3. 定义模型字段
   正常使用ImageField，upload_to参数会直接作用于GCP存储桶内的文件路径，用来组织文件结构：

   from django.db import models
   
   class UserProfile(models.Model):
       # 文件会存在存储桶的user_logos/年/月/日/路径下
       logo = models.ImageField(upload_to='user_logos/%Y/%m/%d/', blank=True, null=True)
   

关于你关心的问题： #

• 调用.save()后数据库存的是什么？
  数据库里存储的是存储桶内的相对路径（比如user_logos/2024/05/20/user1-logo.png），当你访问user_profile.logo.url时，Django会自动拼接成完整的GCP存储桶公开URL（比如https://storage.googleapis.com/your-bucket/user_logos/2024/05/20/user1-logo.png）。
• 是否必须存本地？
  完全不需要。Django的存储后端机制就是为了适配云存储这类远程存储方案，生产环境多实例部署时，本地存储会出现文件同步问题，云存储才是更可靠的选择。
• 数据库存二进制的方案？
  确实不推荐，会导致数据库体积暴涨，读写性能下降，而且无法利用云存储的CDN、缓存等优化能力。

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