关联多表的Django表单验证失败，无法创建数据库记录

核心问题 #

表单提交时无法通过验证，无法创建数据库记录，主要涉及文件上传处理、表单验证规则、错误提示三个关键点，同时补充queryset参数的用法说明。

问题原因及解决步骤 #

1. 未正确处理文件上传 #

表单包含receipt_file（FileField类型），但缺少两个必要设置：

• 表单标签必须添加enctype="multipart/form-data"，否则无法接收上传的文件
• 视图处理POST请求时，需将request.FILES传递给表单实例

2. 表单验证规则不匹配 #

模型中ForeignKey字段仅设置了null=True（允许数据库存储空值），但未设置blank=True（允许表单提交空值），导致下拉框选择空标签时触发验证失败。

3. 错误提示过于笼统 #

当前仅显示通用错误信息，无法定位具体字段的验证问题，需在模板中添加字段级错误提示。

4. queryset参数用法说明 #

queryset用于自定义下拉框的选项来源，默认会自动加载关联模型的所有对象。如果需要过滤选项（比如只显示特定条件的数据），可在表单的__init__方法中设置，示例：

# 只显示地址不为空的公寓
self.fields['is_apartment'].queryset = apartment.objects.exclude(address__exact="")

修改后的完整代码 #

模板（表单部分） #

<form method="post" enctype="multipart/form-data">
     {% csrf_token %}
                    
     <p class="text-light">Тип квитанции: {{ form.is_receipt_type }} 
        {% if form.is_receipt_type.errors %}
            <span class="text-danger">{{ form.is_receipt_type.errors.0 }}</span>
        {% endif %}
     </p>
     <p class="text-light">Адрес: {{ form.is_apartment }} 
        {% if form.is_apartment.errors %}
            <span class="text-danger">{{ form.is_apartment.errors.0 }}</span>
        {% endif %}
     </p>
     <p class="text-light">Плательщик: {{ form.is_owner }} 
        {% if form.is_owner.errors %}
            <span class="text-danger">{{ form.is_owner.errors.0 }}</span>
        {% endif %}
     </p>
     <p class="text-light">Дата: {{ form.date }} 
        {% if form.date.errors %}
            <span class="text-danger">{{ form.date.errors.0 }}</span>
        {% endif %}
     </p>
     <p class="text-light">Файл: {{ form.receipt_file }} 
        {% if form.receipt_file.errors %}
            <span class="text-danger">{{ form.receipt_file.errors.0 }}</span>
        {% endif %}
     </p>
     <span class="text-light">{{ error }}</span>
     {% if form.non_field_errors %}
         <span class="text-danger">{{ form.non_field_errors.0 }}</span>
     {% endif %}

     <button class="btn btn-success mt-5" type="submit">Создать</button>
</form>

views.py #

def create(request):
    error = ''
    if request.method == "POST":
        # 传递request.FILES处理文件上传
        form = receiptForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()
            return redirect('main')
        else:
            error = "Форма была неверной"

    form = receiptForm()

    data = {
        'form': form,
        'error': error
    }
    if request.GET.get('error'): 
        return render(request, "main/main.html", context={'error': request.GET.get('error')})
    return render(request, "main/main.html", data)

models.py（修改receipt模型） #

class receipt(models.Model):
    # 添加blank=True允许表单提交空值
    is_apartment = models.ForeignKey('apartment', on_delete=models.CASCADE, null=True, blank=True)
    is_owner = models.ForeignKey('owner', on_delete=models.CASCADE, null=True, blank=True)
    is_receipt_type = models.ForeignKey('receipt_type', on_delete=models.CASCADE, null=True, blank=True)
    date = models.DateField("Время выписки", null=True, blank=True)
    receipt_file = models.FileField(upload_to='receipt', null=True, blank=True)

    def __str__(self):
        return f'{self.is_apartment} | {self.is_owner} | {self.is_receipt_type} | {self.date}'

forms.py（可选：自定义queryset示例） #

class receiptForm(ModelForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields['is_apartment'].empty_label = "Не выбрано"
        self.fields['is_owner'].empty_label = "Не выбрано"
        self.fields['is_receipt_type'].empty_label = "Не выбрано"
        # 示例：过滤下拉框选项，只显示地址不为空的公寓
        self.fields['is_apartment'].queryset = apartment.objects.exclude(address__exact="")

    class Meta:
        model = receipt
        fields = ['is_apartment', 'is_owner', 'is_receipt_type', 'date', 'receipt_file']

内容的提问来源于stack exchange，提问作者Сергей Мосиенко