ModelForm.save() 默认不保存 ManyToManyField，因为需先调用 instance.save() 再显式调用 save_m2m()；仅当 form.is_valid() 为 True 且未使用 commit=False 时才自动触发，否则须手动处理。
ModelForm.save() 为什么默认不保存 ManyToManyField
Django 的 ModelForm.save() 在内部做了两件事：先保存主模型实例（INSERT/UPDATE），再调用 save_m2m() 写入多对多关系——但这个第二步**仅在满足所有条件时才自动触发**。最常见被跳过的原因是：Meta.fields 里没显式列出该字段，导致整个字段连同提交数据都被忽略，form.cleaned_data 根本不含它，后续自然无从保存。
另一个关键限制：如果视图中用了 form.save(commit=False)，Django 就不会自动调用 save_m2m()，哪怕字段已正确声明。这不是 bug，而是设计——commit=False 意味着你打算自己处理实例，包括关联逻辑。
-
fields = '__all__'看似省事，但若模型含敏感字段（如is_active、created_by），它们也会被渲染并可能被篡改 - 手动定义字段（如
players = forms.ModelMultipleChoiceField(...)）却不在Meta.fields中声明，等于白写 - 外键字段的
__str__返回空或异常，会导致下拉选项为空，用户无法选择，表面看像“没保存”
什么时候必须手动调用 save_m2m()
只有当你在视图中明确使用了 commit=False，且表单确实含 ManyToManyField，才需要手动补上 save_m2m()。注意两个硬性前提：
-
form.is_valid()必须为True，否则save_m2m方法甚至不存在（会抛AttributeError） - 必须先调用
instance.save()，再调用form.save_m2m()；顺序颠倒会报ValueError: Cannot set values on a ManyToManyField... - 检查是否存在再调用更安全：
if hasattr(form, 'save_m2m'): form.save_m2m()
示例片段：
立即学习“Python免费学习笔记（深入）”；
if form.is_valid():
instance = form.save(commit=False)
instance.author = request.user
instance.save() # ✅ 必须先保存实例
if hasattr(form, 'save_m2m'):
form.save_m2m() # ✅ 再保存多对多
读写分离环境下 save_m2m 失败的典型错误
当项目配置了数据库路由（如主从分离），save_m2m() 很容易因跨库引用失败。典型报错：ValueError: Cannot add "<ClassList: Linux3>": instance is on database "google", value is on database "default"。根本原因是：表单中选中的对象来自读库（default），而主实例被写入写库（google），Django 不允许跨库建立关联。
解决思路不是绕开路由，而是让关联数据“脱库”：
- 把
cleaned_data['class_list']从QuerySet转成pk列表：[obj.pk for obj in form.cleaned_data['class_list']] - 再赋值回
cleaned_data，这样save_m2m()会直接查写库取对象，避免跨库 - 或者更彻底：在
form.save()前，用using='google'显式重查对象：Student.objects.using('google').filter(pk__in=pks)
容易被忽略的模板与请求细节
即使后端逻辑全对，前端漏掉一点也会导致多对多“静默失效”：
- HTML 表单缺少
enctype="multipart/form-data"—— 这会影响request.FILES，而 Django 默认要求传入request.FILES才完整解析 POST 数据（尤其含文件字段时） - CheckboxSelectMultiple 或 SelectMultiple 的 name 属性拼写错误，比如写成
player而非players，后端收不到数据 - POST 数据中多选字段未按预期格式提交：浏览器提交的是
players=1&players=3&players=5，不是 JSON 数组；后端拿到的是QuerySet或list，不是字符串 - 前端 JS 动态增删选项后，未同步更新
name属性或未触发表单验证，导致部分选项未提交
真正麻烦的从来不是 save_m2m() 本身，而是它依赖的一长串隐式前提：字段声明、数据存在、数据库一致性、请求完整性——漏掉任意一环，它就安静地什么也不做。
