Django inline formset无required标签、POST报文件字段必填错误如何解决

两个问题其实是同一个配置疏漏衍生出来的连锁问题，核心问题出在文件上传的表单编码配置缺失。

问题根因 #

• 触发POST校验报错的直接原因：模板里的<form>标签没有设置enctype="multipart/form-data"
  HTML表单默认用application/x-www-form-urlencoded编码提交数据，这种模式下浏览器根本不会把用户选中的二进制文件内容传给服务端，只会把用户选的文件名（比如你看到的testpic.jpg）当普通文本塞进POST参数里。
  而Django的FileField根本不读POST里的文本值——它是专门处理文件上传的字段，只会从request.FILES这个QueryDict里读取上传的文件对象。因为你缺了enctype配置，服务端收到的request.FILES是空的，哪怕POST参数里存了个文件名字符串，FileField也会判定为没有收到有效上传内容，抛出“This field is required.”的错误。这和你打印出来的请求参数现象完全匹配。
• 渲染缺失required属性的原因：因为表单没有正确标记为multipart上传模式，Django在渲染文件类字段时，不会主动把必填标识加到input标签上；加上视图里实例化FormSet时也没有把文件请求上下文传进去，最终渲染出的file输入框就丢了required属性，没法触发浏览器原生的客户端校验。

具体修改步骤 #

1. 修正模板的form标签，补充multipart编码配置
   把原来的表单开标签：

   <form id='upload-form-{{ q.id }}' method="post" action="{% url 'submit_and_refresh' %}">
   

   改成：

   <form id='upload-form-{{ q.id }}' method="post" action="{% url 'submit_and_refresh' %}" enctype="multipart/form-data">
   

2. 修正视图里的FormSet实例化逻辑，补上文件参数传入
   FormSet处理文件上传时，除了POST数据，还要把request.FILES传进去才能正确读取上传文件。把POST分支的初始化代码从：

   formset = QualificationDocumentFormSet(request.POST, instance=q)
   

   改成：

   formset = QualificationDocumentFormSet(request.POST, request.FILES, instance=q)
   

3. 手动兜底file字段的required属性，确保客户端校验生效
   如果完成上面两步后，空表单渲染出的file输入框还是没带required属性，可以在生成FormSet工厂的时候，显式给file字段的widget加上required配置，强制输出校验标识：
   把原来的inlineformset_factory定义里的widget配置块，补充file字段的设置：

   QualificationDocumentFormSet = forms.inlineformset_factory(Qualification, QualificationDocument,
       fields=('file', 'name', 'description'),
       widgets={
           # 给文件输入框补required属性
           'file': forms.ClearableFileInput(attrs={'required': True}),
           'name': forms.TextInput(attrs={'placeholder': 'Name'}),
           'description': forms.TextInput(attrs={'placeholder': 'Description'}) },
       extra=1)
   

修复后效果 #

• 渲染阶段：新建空表单的file输入框会带上required属性，用户没选文件就点提交的话，浏览器会直接弹原生校验提示，不会无意义发请求。
• 提交阶段：表单会用multipart编码把真实文件内容传到服务端，Django能从request.FILES里读到有效的上传文件对象，不会再出现明明传了内容还报必填错误的问题。

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