当 Django Formset 验证通过但 cleaned_data 为全空字典列表时，根本原因在于表单字段未被正确识别——关键问题出在 CheckboxInput 是 Widget 而非 Field，且模板中手动渲染的 checkbox 缺乏与 Form 字段的绑定机制。
当 django formset 验证通过但 `cleaned_data` 为全空字典列表时，根本原因在于表单字段未被正确识别——关键问题出在 `checkboxinput` 是 widget 而非 field，且模板中手动渲染的 checkbox 缺乏与 form 字段的绑定机制。
在 Django 中，FormSet 的 cleaned_data 依赖于每个子表单（form）实际声明并成功绑定的字段。你当前的 InvitePlayerForm 存在一个根本性错误：
class InvitePlayerForm(forms.Form):
invited = forms.CheckboxInput() # ❌ 错误：CheckboxInput 是 Widget，不是 Field！
forms.CheckboxInput() 是一个 Widget 类（用于渲染 HTML），不能直接作为表单字段使用。正确的方式是使用 forms.BooleanField（或 forms.BooleanField(required=False)），它自带默认的复选框 Widget，并能正确解析 on/缺失值为 True/False。
同时，你的模板中手动编写了 标签：
<input type="checkbox" name="invited_{{forloop.counter0}}" ...>
这完全绕过了 Django 表单的自动命名与绑定机制。FormSet 期望字段名形如 form-0-invited、form-1-invited（由 management_form 控制），而非 invited_0 —— 这导致 POST 数据虽存在，却无法映射到任何表单字段，因此每个 form.cleaned_data 均为空字典 {}，即使 is_valid() 返回 True（因所有字段均未提交，而 empty_permitted=False 未触发校验失败）。
✅ 正确做法如下：
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
1. 修正表单定义（使用 BooleanField）
# forms.py
class InvitePlayerForm(forms.Form):
invited = forms.BooleanField(
label='Invited',
required=False, # 允许不勾选（即 False）
widget=forms.CheckboxInput(attrs={'class': 'form-check-input'})
)
2. 修正模板：让 Django 自动渲染字段
删除手动 ，改用 {{ form.invited }}，确保命名符合 FormSet 规范：
<!-- create_game_players.html -->
{{ invite_formset.management_form }}
| Name | Invited |
|---|---|
| {{ first_names|get:forloop.counter0 }} {{ last_names|get:forloop.counter0 }} | {{ invite_form.invited }} {# ✅ 自动渲染为 form-0-invited, form-1-invited... #} |
? 提示：{{ invite_form.invited }} 会生成类似 的 HTML，完美匹配 FormSet 的预期字段结构。
3. 修正视图：遍历表单获取真实数据
invite_forms.cleaned_data 是 list[dict]，但每个 dict 只包含该表单中已声明且成功绑定的字段。因此需显式遍历：
# views.py
if invite_forms.is_valid():
selected_indices = []
for i, form in enumerate(invite_forms):
if form.cleaned_data.get('invited'): # ✅ 获取布尔值 True/False
selected_indices.append(i)
print(f"Selected player indices: {selected_indices}")
# 后续可据此从 player_list 中提取 CustomUser 对象
⚠️ 注意事项
- 切勿混用手动 input 和 FormSet 字段名：name="invited_0" 与 form-0-invited 完全不兼容。
- empty_permitted=False 在 BaseFormSet.__init__ 中设置是合理的（防止空行提交），但前提是字段必须存在且可绑定。
- 若需自定义初始数据（如预设某些用户已勾选），应在实例化 formset_factory(..., extra=N) 后，通过 initial=[{'invited': True}, ...] 传入。
- 使用 {{ form.invited.label_tag }} 可渲染标签；添加 {{ form.invited.errors }} 可显示校验错误（尽管 BooleanField 很少报错）。
遵循以上三步，即可彻底解决 cleaned_data 全为空字典的问题，让表单数据真正可用。
