Django渲染HTML表单及Bootstrap下模型数据无法存储问题

我太懂你这种头疼的情况了——纯HTML表单用着好好的，加了Bootstrap美化页面后，显示完全正常，但提交数据就是存不进数据库，admin面板也看不到记录。这种问题几乎都是Bootstrap的表单结构/属性和Django的表单规则不匹配导致的，下面给你一步步排查和解决的思路：

一、先检查表单的核心属性 #

这是最容易踩的坑，先确认这几点：

• 表单必须设置method="POST"：Django默认只处理POST请求的表单数据，GET请求不会触发数据保存逻辑
• 别漏加{% csrf_token %}：这是Django防跨站请求伪造的必填项，纯HTML可能没在意，但Bootstrap表单里很容易漏掉——没有这个的话，Django会直接拒绝请求，数据根本到不了视图层
• action属性如果留空，默认提交到当前页面URL，确保这个URL对应的视图是处理表单提交的那个

示例正确的Bootstrap表单开头：

<form method="POST" action="">
  {% csrf_token %}
  <!-- 下面是Bootstrap的表单控件 -->

二、确认表单控件的name属性匹配模型字段 #

Django是通过控件的name属性来识别对应模型字段的，Bootstrap的表单组件会套很多div样式，但你要确保实际的<input>/<select>等控件的name和models.py里的字段名完全一致。

比如你的模型有个email字段，对应的Bootstrap输入框应该是：

<div class="mb-3">
  <label for="email" class="form-label">邮箱</label>
  <input type="email" class="form-control" id="email" name="email">
</div>

这里的name="email"必须和模型字段名一致，不然视图里request.POST.get('email')会拿到空值，自然存不进数据库。

三、检查视图函数的表单处理逻辑 #

如果表单结构没问题，看看视图代码是不是因为Bootstrap的引入不小心改了逻辑：

• 确保正确判断request.method == 'POST'
• 如果用ModelForm，要正确实例化并验证后保存：

from django.shortcuts import render, redirect
from .forms import YourModelForm

def your_form_view(request):
    if request.method == 'POST':
        form = YourModelForm(request.POST)
        if form.is_valid():  # 必须验证表单有效性，无效的话不会保存
            form.save()
            return redirect('success_page')  # 提交成功后跳转避免重复提交
    else:
        form = YourModelForm()
    return render(request, 'your_template.html', {'form': form})

• 如果是手动处理POST数据，要确保每个必填字段都从request.POST里正确取值，并且没有遗漏：

if request.method == 'POST':
    username = request.POST.get('username')
    phone = request.POST.get('phone')
    # 先检查必填字段是否为空
    if username and phone:
        YourModel.objects.create(username=username, phone=phone)

四、查看表单验证错误信息 #

有时候表单提交了但因为验证不通过没保存，你可以在模板里加个错误提示块，看看具体问题：

{% if form.errors %}
  <div class="alert alert-danger mt-3">
    {% for field in form %}
      {% for error in field.errors %}
        <small>{{ field.label }}: {{ error }}</small>
      {% endfor %}
    {% endfor %}
    {% for error in form.non_field_errors %}
      <small>{{ error }}</small>
    {% endfor %}
  </div>
{% endif %}

提交后如果有错误，页面会直接显示，比如某个必填字段没填、格式不符合要求等。

五、用浏览器开发者工具排查请求 #

打开浏览器F12的Network标签，提交表单后看请求细节：

• 如果返回403状态码：90%是没加csrf_token
• 看Request Payload里有没有你提交的数据：如果是空的，说明表单控件的name属性没设置对，或者提交按钮不是type="submit"

我之前遇到过一模一样的问题，就是Bootstrap表单里漏加了csrf_token，导致请求被Django拦截，数据根本没传到视图层，排查半天才发现。按上面的步骤走，应该很快能找到问题~

内容的提问来源于stack exchange，提问作者Qhadeer syed abdul