Django Storages+Boto3配置异常：静态文件错误指向S3

你的配置问题出在Django 4.2+的新配置与旧配置冲突，以及静态文件存储的URL参数缺失，导致静态文件的URL生成逻辑被错误引导到了S3的媒体路径下。以下是具体的问题点和修正方案：

核心问题拆解 #

1. Django 4.2+引入的STORAGES配置会直接覆盖旧版的STATICFILES_STORAGE和DEFAULT_FILE_STORAGE，同时保留两类配置会引发逻辑冲突，导致静态文件存储后端未正确生效。
2. STORAGES中staticfiles的配置缺少url参数，Django无法明确静态文件的URL前缀，错误 fallback 到了默认存储（S3）的URL规则，再叠加你配置的MEDIA_URL前缀，就出现了在/media/路径下查找静态文件的诡异情况。
3. 媒体文件的S3存储未指定路径前缀，可能导致后续文件管理混乱。

修正后的完整配置 #

import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

# 静态文件本地配置
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

# S3环境变量提取
AWS_STORAGE_BUCKET_NAME = os.getenv('AWS_STORAGE_BUCKET_NAME')
AWS_S3_REGION_NAME = os.getenv('AWS_S3_REGION_NAME', 'us-east-1')

# 媒体文件URL（基于S3存储桶）
MEDIA_URL = f'https://{AWS_STORAGE_BUCKET_NAME}.s3.{AWS_S3_REGION_NAME}.amazonaws.com/media/'

# Django 4.2+ 统一使用STORAGES配置（移除旧版冲突项）
STORAGES = {
    # 媒体文件存储到S3，指定路径前缀为media/
    'default': {
        'BACKEND': 'storages.backends.s3boto3.S3Boto3Storage',
        'OPTIONS': {
            'bucket_name': AWS_STORAGE_BUCKET_NAME,
            'region_name': AWS_S3_REGION_NAME,
            'default_acl': 'public-read',
            'file_overwrite': False,
            'custom_domain': f'{AWS_STORAGE_BUCKET_NAME}.s3.{AWS_S3_REGION_NAME}.amazonaws.com',
            'location': 'media',  # 强制媒体文件存到S3的media目录下
        },
    },
    # 静态文件存储到本地，明确指定URL前缀
    'staticfiles': {
        'BACKEND': 'django.core.files.storage.FileSystemStorage',
        'OPTIONS': {
            'location': STATIC_ROOT,
            'url': STATIC_URL,  # 关键：告诉Django静态文件的URL前缀是本地的/static/
        },
    }
}

后续操作注意事项 #

1. 清理旧配置：删除原代码中的STATICFILES_STORAGE和DEFAULT_FILE_STORAGE两行，避免再次引发冲突。
2. 收集静态文件：生产环境执行python manage.py collectstatic，确保所有静态文件（包括Admin的CSS/JS）被收集到本地的STATIC_ROOT目录。
3. 服务器配置：确保你的Web服务器（如Nginx）正确映射/static/路径到STATIC_ROOT的物理目录，这样用户访问静态文件时会直接读取本地资源，而非S3。
4. 环境变量检查：确认AWS_STORAGE_BUCKET_NAME和AWS_S3_REGION_NAME环境变量已正确设置，避免空值导致URL构造错误。

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