Django中如何将formset empty_form数据提交至数据库？

核心问题分析 #

你的代码存在两个关键问题导致empty_form数据无法保存：

1. 视图中未将formset与父模型实例绑定，子表单数据无法关联到父记录
2. 模板中未处理empty_form的__prefix__占位符，动态添加的表单字段无法被Django识别为formset的一部分

分步解决方案 #

1. 修正视图逻辑 #

POST请求时，必须将formset绑定到已保存（或待保存）的父模型实例上，确保子表单数据能关联到父记录：

from django.shortcuts import render, redirect
from .forms import InvoiceForm, ItemFormSet

def invoice_edit(request, pk=None):
    # 处理更新场景（可选）
    invoice_instance = Invoice.objects.get(pk=pk) if pk else None

    if request.method == 'POST':
        form = InvoiceForm(request.POST, instance=invoice_instance)
        if form.is_valid():
            # 先获取父实例（暂不保存，等formset验证通过）
            invoice = form.save(commit=False)
            # 将formset与父实例绑定
            formset = ItemFormSet(request.POST, instance=invoice)
            if formset.is_valid():
                invoice.save()
                formset.save()
                return redirect("/")
    else:
        # GET请求时，绑定空实例或已有实例
        form = InvoiceForm(instance=invoice_instance)
        formset = ItemFormSet(instance=invoice_instance or Invoice())
    
    return render(request, 'invoice_form.html', {'form': form, 'formset': formset})

2. 修复模板与动态添加逻辑 #

需要将empty_form作为模板存储，通过JS替换占位符并更新表单计数：

<form method="post">
  {% csrf_token %}
  <!-- 父表单字段 -->
  {{ form.as_p }}

  <!-- 子表单集表格 -->
  <table>
    <thead>
      <tr>
        <th>商品名称</th>
        <th>数量</th>
        <th>单价</th>
      </tr>
    </thead>
    <tbody id="formset-rows">
      {% for form in formset %}
        <tr class="form-row">
          {% for field in form.visible_fields %}
            <td>{{ field }} {{ field.errors }}</td>
          {% endfor %}
        </tr>
      {% endfor %}
    </tbody>
  </table>

  <!-- 隐藏的empty_form模板 -->
  <div id="empty-form-tpl" style="display:none;">
    <tr class="form-row">
      {% for field in formset.empty_form.visible_fields %}
        <td>{{ field }}</td>
      {% endfor %}
    </tr>
  </div>

  {{ formset.management_form }}
  <button type="button" id="add-row">添加字段</button>
  <button type="submit">保存</button>
</form>

<script>
  document.addEventListener('DOMContentLoaded', function() {
    const addBtn = document.getElementById('add-row');
    const rowsContainer = document.getElementById('formset-rows');
    const emptyTpl = document.getElementById('empty-form-tpl').innerHTML;
    const totalFormsInput = document.getElementById('id_invoiceitem_set-TOTAL_FORMS');

    addBtn.addEventListener('click', function() {
      const currentCount = parseInt(totalFormsInput.value);
      // 替换empty_form中的__prefix__为当前计数
      const newRow = emptyTpl.replace(/__prefix__/g, currentCount);
      rowsContainer.insertAdjacentHTML('beforeend', newRow);
      // 更新总表单数量，让Django识别新行
      totalFormsInput.value = currentCount + 1;
    });
  });
</script>

3. 优化表单集配置（可选） #

可以将extra设为0，避免默认显示空行，完全通过按钮动态添加：

ItemFormSet = inlineformset_factory(
    Invoice, 
    InvoiceItem, 
    form=InvoiceItemForm, 
    extra=0,  # 取消默认空行
    can_delete=False
)

关键注意点 #

• 必须绑定父实例：formset只有关联到父模型实例，才能将子数据保存到数据库并建立外键关联
• 替换占位符：empty_form中的__prefix__是Django的占位符，必须替换为递增数字，否则提交的字段无法被formset识别
• 更新表单计数：每次添加新行后，必须更新TOTAL_FORMS的值，否则formset验证会忽略超出数量的表单行

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