如何在Django的forms.py中读取表单提交的额外动态字段数据？

解决方案1：直接从表单的self.data中读取 #

动态生成的字段会被包含在表单提交的请求数据里，即使不在ModelForm的fields定义中，你也可以在clean方法里通过self.data直接获取：

class MailTemplateForm(forms.ModelForm):
    class Meta:
        model = MailTemplate
        fields = ['name', 'tfile']

    def clean(self):
        cleaned_data = super().clean()
        # 获取单个动态字段值
        customer_name = self.data.get('customer_name')
        # 批量收集前缀统一的动态字段（比如前缀为tpl_var_）
        dynamic_vars = {}
        for key, value in self.data.items():
            if key.startswith('tpl_var_'):
                var_name = key.replace('tpl_var_', '')
                dynamic_vars[var_name] = value
        # 将收集到的动态数据存入cleaned_data，方便后续处理
        cleaned_data['dynamic_vars'] = dynamic_vars
        return cleaned_data

解决方案2：动态向ModelForm添加字段 #

如果希望动态字段能享受Django表单的内置验证逻辑，并自动进入cleaned_data，可以在表单的__init__方法中，根据schema字段的内容动态创建对应表单字段：

class MailTemplateForm(forms.ModelForm):
    class Meta:
        model = MailTemplate
        fields = ['name', 'tfile']

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 仅在编辑已有模板时添加动态字段（此时schema已保存到实例）
        if self.instance.pk:
            schema = self.instance.schema
            for field_info in schema:
                field_name = field_info['name']
                # 根据schema定义的字段类型创建对应表单字段
                if field_info['type'] == 'text':
                    self.fields[field_name] = forms.CharField(
                        required=field_info.get('required', False),
                        label=field_info.get('label', field_name)
                    )
                elif field_info['type'] == 'select':
                    self.fields[field_name] = forms.ChoiceField(
                        choices=field_info['choices'],
                        required=field_info.get('required', False),
                        label=field_info.get('label', field_name)
                    )
                # 可扩展支持日期、数字等其他字段类型

    def clean(self):
        cleaned_data = super().clean()
        # 此时动态字段的数据已自动存入cleaned_data，直接调用即可
        order_status = cleaned_data.get('order_status')
        return cleaned_data

注意事项 #

• 前端渲染动态字段时，确保name属性设置正确，避免与模型已有字段重名。
• 使用HTMX提交表单时，要确保请求携带CSRF令牌（可通过{% csrf_token %}或HTMX的hx-headers传递）。
• 若动态字段涉及文件上传，需将表单的enctype设置为multipart/form-data。

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