Django 4.1中upload_to与storage功能异常求助

问题描述 #

将Django从2.x版本升级至4.1后，原本正常的跨MEDIA_ROOT文件上传功能异常：

• 文件已成功上传至/data目录下指定路径
• 无法将文件路径写入数据库，抛出错误：

The joined path (upload_to) is located outside of the base path component (MEDIA_ROOT ).

相关代码 #

模型字段定义：

file = models.FileField(
        upload_to=get_file_path,
        storage=AbsolutePathStorage(),
        max_length=500,
    )

自定义存储类：

from django.core.files.storage import FileSystemStorage


class AbsolutePathStorage(FileSystemStorage):
    """Storage that allows storing files given absolute paths."""

    def path(self, name: str) -> str:
        """Override path validation to allow absolute paths."""
        # Return name if it's a absolute path.
        if name.startswith("/"):
            return name

        # Return regular joined path if this is a relative path.
        return super().path(name)

上传路径生成函数：

def get_file_path(instance, filename):
    root_data = '/data'
    return os.path.join(root_data, instance.relative_path)

问题原因 #

Django 4.x强化了FileField的路径验证逻辑，在路径写入数据库前，会强制检查upload_to生成的路径是否在MEDIA_ROOT范围内。即使自定义AbsolutePathStorage绕过了存储阶段的验证，写入数据库前的检查依然会触发。

解决方案 #

自定义FileField跳过路径范围验证：

from django.db.models import FileField

class UnrestrictedFileField(FileField):
    def generate_filename(self, instance, filename):
        # 直接使用upload_to生成的路径，不做MEDIA_ROOT拼接与范围检查
        return self.upload_to(instance, filename)

替换模型中原有字段：

file = UnrestrictedFileField(
    upload_to=get_file_path,
    storage=AbsolutePathStorage(),
    max_length=500,
)

原理说明 #

原生FileField的generate_filename方法会自动拼接MEDIA_ROOT并验证路径合法性，自定义字段直接返回upload_to生成的绝对路径，绕过该验证步骤，同时保留自定义存储类的路径处理逻辑，确保文件正常存储的同时，绝对路径能写入数据库。

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