Django FileField无法保存空值的问题排查

问题描述 #

Question模型的image_before字段为ImageField，已设置null=True、blank=True、default=None，但通过API的POST请求创建不带文件的对象时，抛出ValueError，而Django Admin可正常创建未指定文件的对象。

报错信息 #

ValueError: The 'image_before' attribute has no file associated with it.

请求示例 #

{   
    "type": "Type",
    "question": "Text",
    "category": [
        1
    ]
}

模型代码 #

class Question(models.Model):

    class Meta:
        db_table = 'questions'

    question_type = models.CharField(
        max_length=300,
    )

    category = models.ManyToManyField(
        Category,
    )

    question_text = models.CharField(
        max_length=300,
    )

    image_before = models.ImageField(
        upload_to='media/',
        null=True,
        blank=True,
        default=None,
    )

    correct_answer= models.CharField(
        max_length=300,
        blank=True
    )

API端点及视图代码 #

API端点：

path('api/v1/create-question/', QuestionCreateAPI.as_view())

视图代码：

class QuestionCreateAPI(APIView):

    def post(self, request, format=None):
        obj, create = create_question(request.data)

        if create:
            return Response(obj, status=status.HTTP_201_CREATED)

        return Response(obj, status=status.HTTP_400_BAD_REQUEST)

create_question函数代码 #

def create_question(data):
    media_data = data.get('media_data')
    
    if media_data:
       question = Question.objects.create(
                question_type=data['type'],
                question_text=data['question'],
                time_to_answer=data.get('time_to_answer', 0),
                show_image=media_data.get('show_image', False),
                image_before=media_data.get('image', {}).get('before'),
                image_after=media_data.get('image', {}).get('after'),
                video_before=media_data.get('video', {}).get('before'),
                video_after=media_data.get('video', {}).get('after'),
                correct_answer=data['correct_answer'],
                answers=data.get('answers', '')
            )
    else:
        question = Question.objects.create(
                question_type=data['type'],
                question_text=data['question'],
                question_text=data['correct_answer'],  # 此处存在笔误，重复赋值question_text
            )
    
    if round_id := data.get('round_id'):
            question.rounds = round_id
    
    return model_to_dict(question), True

原因分析及解决办法 #

核心原因 #

1. model_to_dict序列化问题：调用model_to_dict(question)时，会尝试访问ImageField的file属性，即使字段值为None，也会触发"无关联文件"的错误。Django Admin不使用model_to_dict序列化，因此不会出现该问题。
2. 代码笔误：else分支中重复赋值question_text=data['correct_answer']，应该是correct_answer=data['correct_answer']，会导致question_text被错误覆盖。
3. 未处理ManyToMany字段：请求中传入了category数组，但创建逻辑未关联该字段。

解决步骤 #

1. 替换model_to_dict序列化方式：
   改用Django REST Framework的Serializer序列化对象，避免直接访问FileField的敏感属性：

   # 先定义Serializer
   from rest_framework import serializers
   class QuestionSerializer(serializers.ModelSerializer):
       class Meta:
           model = Question
           fields = '__all__'  # 或指定需要返回的字段
   
   # 修改create_question返回逻辑
   def create_question(data):
       # ... 原创建代码 ...
       serializer = QuestionSerializer(question)
       return serializer.data, True
   

   或者手动构造返回字典，按需处理FileField：

   def create_question(data):
       # ... 原创建代码 ...
       response_data = {
           'id': question.id,
           'question_type': question.question_type,
           'question_text': question.question_text,
           'correct_answer': question.correct_answer,
           'image_before': question.image_before.url if question.image_before else None,
           # 其他字段按需添加
       }
       return response_data, True
   

2. 修复代码笔误：
   将else分支中的question_text=data['correct_answer']修改为correct_answer=data['correct_answer']。

3. 补充ManyToMany字段关联逻辑：
   创建对象后添加category关联：

   def create_question(data):
       # ... 原创建代码 ...
       # 关联category字段
       if 'category' in data:
           question.category.set(data['category'])
       # ... 返回逻辑 ...
   

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