Django表单.initial属性失效求助：importo等字段无法正确初始化

问题背景 #

在Django项目中，Fattura模型对应的EntrataForm表单，在__init__方法中为tipo、viaggi、cliente、importo四个字段设置了initial值，但提交表单时这些字段的初始值丢失，触发ValidationError：

• 最初仅importo字段无法正确初始化，__init__中打印的importo值正确，但执行form.is_valid()时importo为None
• 改用{{form.as_p}}渲染模板后，tipo、viaggi也出现必填错误，错误信息如下：

<ul class="errorlist"><li>viaggi<ul class="errorlist"><li>"" non è un valore valido.</li></ul></li><li>importo<ul class="errorlist"><li>Questo campo è obbligatorio.</li></ul></li><li>tipo<ul class="errorlist"><li>Questo campo è obbligatorio.</li></ul></li><li>__all__<ul class="errorlist nonfield"><li>L'importo non può essere None.</li></ul></li></ul>

相关代码 #

模型代码 #

class Fattura(models.Model):
    TIPO_CHOICES = [
        ('T', 'Tasse'),
        ('B', 'Burocrazia'),
        ('C', 'Clienti'),
        ('S', 'Spese'),
    ]

    numero = models.CharField(max_length=20)
    data = models.DateField(default=django.utils.timezone.now)
    tipo = models.CharField(max_length=1, choices=TIPO_CHOICES)
    importo = models.DecimalField(max_digits=10, decimal_places=2)
    cliente = models.ForeignKey(Cliente, on_delete=models.CASCADE, null=True, blank=True)
    viaggi = models.ManyToManyField(Viaggio)

    def clean(self):
        if self.importo is None:
            raise ValidationError('L\'importo non può essere None.')

    def __str__(self):
        return f"{self.numero} - {self.data} - {self.importo} - {self.tipo}"

表单代码 #

class EntrataForm(forms.ModelForm):
    class Meta:
        model = Fattura
        fields = ['numero', 'data', 'cliente','viaggi','importo','tipo']

    def __init__(self, *args, **kwargs):
        id = kwargs.pop('id',None)
        super(EntrataForm, self).__init__(*args, **kwargs)
        importo_finale = 0
        viaggi = Viaggio.objects.filter(cliente_id=id)
        for viaggio in viaggi:
            importo_finale += viaggio.prezzo_viaggio
        print(id)

        self.fields['tipo'].widget.attrs['readonly'] = True
        self.fields['tipo'].required = False
        self.fields['tipo'].widget = forms.HiddenInput()
        self.fields['tipo'].initial = 'C'
        self.fields['viaggi'].widget.attrs['readonly'] = True
        self.fields['viaggi'].required = False
        self.fields['viaggi'].widget = forms.HiddenInput()
        self.fields['viaggi'].initial = viaggi
        self.fields['cliente'].widget.attrs['readonly'] = True
        self.fields['cliente'].required = False
        self.fields['cliente'].widget = forms.HiddenInput()
        self.fields['cliente'].initial = Cliente.objects.get(id=id)
        self.fields['importo'].widget.attrs['readonly'] = True
        self.fields['importo'].required = False
        self.fields['importo'].widget = forms.HiddenInput()
        self.fields['importo'].initial = importo_finale
        print(self.fields['importo'].initial)

视图代码 #

def entrata(request, id):
    viaggi = Viaggio.objects.filter(cliente_id=id)
    cliente = Cliente.objects.get(id=id)
    if request.method == 'POST':
        form = EntrataForm(request.POST, id=id)
        if form.is_valid():
            nuova_fattura = form.save()
            return redirect('fatture')
        else:
            print(form.errors)
            return redirect('fatture')
    else:
        form = EntrataForm(id=id)
        return render(request, 'fatture/crea/cliente/entrata.html', {'form': form, 'cliente': cliente, 'viaggi':viaggi})

模板代码（原始版本） #

{% extends 'fatture/index.html' %}

{% block corpo %}
<body>
    <button onclick="location.href = '{% url 'fatture' %}'" id="indietro">Indietro</button>
    <section>
        <h2>Viaggi per {{ cliente }}</h2>
        <h3>Seleziona i viaggi che vuoi inserire nella fattura</h3>
        <div id="banner">
            <form id="fattura-form" method="post" action="{% url 'entrata' cliente.id%}">
    {% csrf_token %}

    <label for="{{ form.numero.id_for_label }}">Numero:</label>
    {{ form.numero }}
    <br>

    <label for="{{ form.data.id_for_label }}">Data:</label>
    {{ form.data }}
    <br>

    <button type="submit">Inserisci</button>
</form>

            <table id="tabella-fatture" style="margin-top: 30px;">
    <thead>
        <tr>
            <th>Data</th>
            <th>Distanza</th>
            <th>Prezzo Viaggio</th>
        </tr>
    </thead>
    <tbody>
        {% for viaggio in viaggi %}
            <tr>
                <td>{{ viaggio.data_viaggio }}</td>
                <td>{{ viaggio.distanza_km }}</td>
                <td>{{ viaggio.prezzo_viaggio }}</td>
            </tr>
        {% endfor %}
    </tbody>
</table>
    </div>
    </section>

</body>

{% endblock %}

问题原因 #

1. 模板未渲染隐藏字段：原始模板仅渲染了numero和data字段，tipo、viaggi、cliente、importo被设置为HiddenInput但未在模板中输出，表单提交时这些字段未被发送到后端，初始值无法被获取。
2. initial设置方式错误：直接给self.fields['xxx'].initial赋值不符合模型表单的初始化逻辑，POST请求时super().__init__会优先从request.POST取值，而POST中无这些字段，会覆盖初始值。
3. ManyToMany字段赋值错误：viaggi是ManyToMany字段，直接将QuerySet赋值给initial无效，需传递主键列表。
4. required属性矛盾：表单中设置required=False仅影响前端验证，模型中tipo、importo为必填字段（未设置null=True/blank=True），后端模型验证依然会生效。

解决办法 #

1. 确保模板渲染所有隐藏字段 #

手动渲染时需添加隐藏字段，或使用{{ form.as_p }}自动渲染所有字段：

{{ form.tipo }}
{{ form.cliente }}
{{ form.viaggi }}
{{ form.importo }}

2. 正确设置initial值 #

修改表单__init__方法，通过initial字典传递初始值，而非直接修改字段的initial属性：

def __init__(self, *args, **kwargs):
    id = kwargs.pop('id', None)
    # 初始化initial字典
    initial = kwargs.get('initial', {})
    importo_finale = 0
    viaggi = Viaggio.objects.filter(cliente_id=id)
    for viaggio in viaggi:
        importo_finale += viaggio.prezzo_viaggio
    
    # 填充初始值
    initial['tipo'] = 'C'
    initial['cliente'] = id  # ForeignKey传递主键即可
    initial['viaggi'] = [v.id for v in viaggi]  # ManyToMany传递主键列表
    initial['importo'] = importo_finale
    kwargs['initial'] = initial
    
    super(EntrataForm, self).__init__(*args, **kwargs)
    
    # 设置字段为隐藏输入
    self.fields['tipo'].widget = forms.HiddenInput()
    self.fields['viaggi'].widget = forms.HiddenInput()
    self.fields['cliente'].widget = forms.HiddenInput()
    self.fields['importo'].widget = forms.HiddenInput()
    
    # 关闭前端必填验证
    for field in ['tipo', 'viaggi', 'cliente', 'importo']:
        self.fields[field].required = False

3. 表单clean方法补全字段值 #

在表单的clean方法中主动补全未提交的字段值，确保模型验证通过：

def clean(self):
    cleaned_data = super().clean()
    # 若POST中无值，使用initial值补全
    if not cleaned_data.get('tipo'):
        cleaned_data['tipo'] = self.initial.get('tipo')
    if not cleaned_data.get('cliente'):
        cleaned_data['cliente'] = Cliente.objects.get(id=self.initial.get('cliente'))
    if not cleaned_data.get('importo'):
        cleaned_data['importo'] = self.initial.get('importo')
    return cleaned_data

4. 模型字段兼容（可选） #

若业务允许，可修改模型字段添加blank=True，避免后端验证报错：

tipo = models.CharField(max_length=1, choices=TIPO_CHOICES, blank=True)
importo = models.DecimalField(max_digits=10, decimal_places=2, blank=True)

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