Django配置双Google Storage桶遇ADC错误及存储验证问题

一、ADC错误的原因及优化方案 #

• 你手动初始化的storage.Client仅用于自身列桶操作，Django的django-storages库在处理文件存储时，会独立创建专属的GCS客户端实例，不会复用你在settings里手动构造的client或credentials对象。
• django-storages的GCS后端默认通过Application Default Credentials（ADC）机制加载凭证，而非读取你手动生成的credentials。所以即便你的列桶代码正常运行，只要storages后端找不到ADC凭证，就会抛出报错。

你通过临时文件+GOOGLE_APPLICATION_CREDENTIALS环境变量解决问题的逻辑是：设置该变量后，ADC流程能找到凭证文件，storages后端即可正常加载凭证。

更优的无文件方案是直接在settings中配置GS_CREDENTIALS，让storages后端跳过ADC流程，直接使用你从环境变量加载的凭证：

# settings.py
from google.oauth2 import service_account
import environ

env = environ.Env()

# 加载服务账号信息，注意处理私钥换行符
service_account_info = {
    "type": env("TYPE"),
    "project_id": env("PROJECT_ID"),
    "private_key_id": env("PRIVATE_KEY_ID"),
    "private_key": env("PRIVATE_KEY").replace('\\n', '\n'),
    "client_email": env("CLIENT_EMAIL"),
    "client_id": env("CLIENT_ID"),
    "auth_uri": env("AUTH_URI"),
    "token_uri": env("TOKEN_URI"),
    "auth_provider_x509_cert_url": env("AUTH_PROVIDER_X509_CERT_URL"),
    "client_x509_cert_url": env("CLIENT_X509_CERT_URL")
}

# 直接配置给storages后端使用
GS_CREDENTIALS = service_account.Credentials.from_service_account_info(service_account_info)

# 其余GCS配置保持不变
DEFAULT_FILE_STORAGE = 'fly_io_test.gcloud.GoogleCloudMediaFileStorage'
STATICFILES_STORAGE = "storages.backends.gcloud.GoogleCloudStorage"
GS_STATIC_BUCKET_NAME = env("DEV_STATIC_FILES_BUCKET_NAME")
GS_MEDIA_BUCKET_NAME = env("DEV_MEDIA_FILES_BUCKET_NAME")
STATIC_URL = f"https://storage.googleapis.com/{GS_STATIC_BUCKET_NAME}/admin/"    
MEDIA_URL = f"https://storage.googleapis.com/{GS_MEDIA_BUCKET_NAME}/"

二、双桶存储的有效性验证 #

静态文件存储 #

你使用的storages.backends.gcloud.GoogleCloudStorage会自动读取GS_STATIC_BUCKET_NAME作为存储桶，执行collectstatic后，静态文件会写入指定的静态桶，当前配置有效。

媒体文件存储 #

你的自定义GoogleCloudMediaFileStorage需要确保正确关联GS_MEDIA_BUCKET_NAME，否则可能使用默认桶或报错。正确的自定义类示例如下：

# fly_io_test/gcloud.py
from storages.backends.gcloud import GoogleCloudStorage
from django.conf import settings

class GoogleCloudMediaFileStorage(GoogleCloudStorage):
    bucket_name = settings.GS_MEDIA_BUCKET_NAME
    # 可选：自定义文件存储路径，比如添加前缀
    def get_name(self, name):
        return f"media/{name}"

只要该类正确设置bucket_name为GS_MEDIA_BUCKET_NAME，媒体文件上传时就会写入对应的媒体桶，配置有效。

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