Django Contact表单提交数据无法在admin后台展示的问题排查

• 表单类定义错误
  你在forms.py中让ContactForm继承了forms.Form（普通无模型关联的表单基类），却额外添加了Meta类关联Contact模型——这个写法对普通表单完全无效，模型关联逻辑只有继承forms.ModelForm时才会生效。
• 视图保存逻辑完全不符合Django ORM规范
  你在视图中写的保存逻辑是直接给Contact模型类本身赋值、再调用类的save()方法，完全没有实例化出具体的模型对象，根本不会生成数据库记录，自然也不会在admin端显示。同时存在两个细节错误：
  • 字段名大小写不匹配：模型定义的字段是BookID，你代码里写的是BookId
  • 表单数据获取方式错误：校验通过后应该从cleaned_data字典取数据，而不是直接对表单对象调用.get()
• 文件上传请求处理遗漏
  表单包含ImageField，但你在视图中实例化表单时只传了request.POST，没有传入request.FILES，上传的图片文件根本不会被表单接收，会直接导致表单验证不通过。
• 模型__str__方法字段名拼写错误
  模型类中定义的BookID字段，在__str__方法里写成了self.BookId，后续只要触发方法调用就会抛出AttributeError。
• 模板上下文遗漏表单实例
  视图返回渲染结果时，根本没有把校验后的user_form实例传入上下文，表单即使校验失败，也无法在页面上展示具体的错误提示。

修正后的 models.py #

class Contact(models.Model):
    BookID = models.CharField(max_length=30)
    BookTitle = models.CharField(max_length=30)
    Author = models.CharField(max_length=35)
    # 补充空值配置，匹配模板中"图片可选"的设计
    UploadImage = models.ImageField(upload_to='ContactImg', blank=True, null=True)

    def __str__(self):
        # 修正大小写不匹配问题
        return self.BookID

修正后的 forms.py #

# 改为继承ModelForm，自动关联模型字段
class ContactForm(forms.ModelForm):
    BookID = forms.CharField(max_length=30, required=True)
    BookTitle = forms.CharField(max_length=30, required=True)
    Author = forms.CharField(max_length=35, required=True)
    UploadImage = forms.ImageField(required=False)

    class Meta:
        model = Contact
        fields = ('BookID', 'BookTitle', 'Author','UploadImage')

修正后的 views.py #

def ContactUs(request):
    context_dict = {}
    if request.user.is_authenticated:
        context_dict['logged_in'] = True
    else:
        context_dict['logged_in'] = False

    user_form = ContactForm()
    if request.method == 'POST':
        # 同时传入POST参数和上传的文件流
        user_form = ContactForm(request.POST, request.FILES)
        if user_form.is_valid():
            # 直接调用ModelForm自带的save()方法，自动创建模型实例并写入数据库
            user_form.save()
            return redirect('readingTime:home')
        else:
            print(user_form.errors)
            messages.error(request, '表单包含错误，请仔细检查')
    else:
        user_form = ContactForm()
    
    # 将表单实例传入模板上下文
    context_dict['user_form'] = user_form
    return render(request,"readingTime/ContactUs.html", context=context_dict)

注意：使用ModelForm后不需要手动逐字段给模型赋值，调用.save()就会自动完成对象创建和数据库写入，提交后的数据会自动同步到admin端。

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