配置AWS S3后Django执行createsuperuser报错：不支持绝对路径

问题根源 #

配置AWS S3作为文件存储后端后，执行python manage.py createsuperuser触发信号创建Profile时，Django会尝试处理ImageField和FileField的默认值，但S3Boto3Storage后端的path()方法不支持绝对路径解析操作，直接抛出NotImplementedError。

解决方案 #

方案一：自定义S3存储后端重写path方法 #

创建自定义存储类，覆盖S3后端的path()方法，跳过本地路径检查：

1. 在你的Django应用中新建storage.py文件，写入以下代码：

from storages.backends.s3boto3 import S3Boto3Storage

class CustomS3Storage(S3Boto3Storage):
    def path(self, name):
        # 直接返回文件名，避免触发本地路径解析逻辑
        return name

2. 修改settings.py中的存储配置，替换为自定义存储类：

DEFAULT_FILE_STORAGE = '你的应用名.storage.CustomS3Storage'

方案二：调整信号中Profile的创建逻辑 #

由于avatar和resume字段已设置null=True和blank=True，可以在创建Profile时暂时不依赖默认值，避免触发默认文件的路径检查：

修改signals.py中的create_profile函数：

@receiver(post_save, sender=User)
def create_profile(sender, instance, created, **kwargs):
    if created:
        # 为必填的bio字段设置默认值，跳过avatar和resume的默认值填充
        Profile.objects.create(user=instance, bio='')

额外注意事项 #

• 确保settings.py中AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_STORAGE_BUCKET_NAME已填写真实有效信息。
• 确认S3桶内的default.jpg和resume.docx文件权限为public-read，保证Django能正常访问。
• bio字段为必填项，创建Profile时必须传入有效值，否则会触发数据库完整性错误。

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