Django对接DigitalOcean CDN时{% static %}标签与file.url路径冲突问题

核心问题原因 #

django-storages的S3Boto3Storage类会默认继承全局settings中所有AWS_开头的配置，你全局配置AWS_S3_CUSTOM_DOMAIN后，所有使用S3存储的场景（包括静态资源、用户上传资源）都会共用这个域名配置，才会出现路径串到静态资源空间的问题。

修复步骤 #

1. 移除全局配置中的AWS_S3_CUSTOM_DOMAIN参数，不再全局绑定静态资源空间的域名。
2. 在你的storage_backends.py文件中分别定义两个独立的存储类，各自绑定对应的空间配置：

# storage_backends.py
from storages.backends.s3boto3 import S3Boto3Storage

# 静态资源专用存储类
class StaticStorage(S3Boto3Storage):
    bucket_name = 'exactestate-staging' # 你的静态资产空间名
    custom_domain = f'{bucket_name}.nyc3.digitaloceanspaces.com'
    location = 'static' # 对应静态资源存放的目录，和STATIC_URL的后缀匹配
    default_acl = 'public-read' # 静态资源一般设为公开读，可按需调整

# 客户端资源专用存储类
class ClientResourceStorage(S3Boto3Storage):
    bucket_name = '替换为你的客户端资源Space名称'
    custom_domain = f'{bucket_name}.nyc3.digitaloceanspaces.com'
    location = 'media' # 按需设置客户端资源的存放目录
    default_acl = 'private' # 客户端隐私资源可设为private，按需调整

3. 修改settings.py中的配置，指定不同场景使用对应的存储类：

# 原有其他S3配置保留，删除全局的AWS_S3_CUSTOM_DOMAIN即可
AWS_S3_REGION_NAME = 'nyc3'
AWS_S3_ENDPOINT_URL = f'https://{AWS_S3_REGION_NAME}.digitaloceanspaces.com'
AWS_DEFAULT_ACL = 'private'
AWS_ACCESS_KEY_ID = '你的访问密钥'
AWS_SECRET_ACCESS_KEY = '你的访问密钥'

# 静态资源配置
STATICFILES_STORAGE = 'storage_backends.StaticStorage'
STATIC_URL = f'https://{StaticStorage.custom_domain}/{StaticStorage.location}/'

# 客户端上传资源默认存储类配置
DEFAULT_FILE_STORAGE = 'storage_backends.ClientResourceStorage'
# 如果你有部分特殊字段需要单独用其他存储类，也可以在模型字段中直接指定：
# from storage_backends import ClientResourceStorage
# file = models.FileField(storage=ClientResourceStorage())

效果验证 #

修改完成后：

• 模板{% static %}标签会使用StaticStorage的配置生成静态资产空间的正确路径
• 模型文件字段调用file.url时，会使用ClientResourceStorage的配置生成客户端资源空间的路径，两者完全独立不会互相干扰

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