Django报错：save()收到意外关键字参数'commit'，如何解决？

嘿，这个问题我在Django开发中碰到过好多次，其实根源很简单——你自定义的save()方法没有接收commit这个参数，但Django在调用表单的save方法时，默认会传递这个参数（哪怕你没显式传入）。

为什么会报错？ #

Django的ModelForm基类自带的save()方法是包含commit参数的（默认值为True）。当你重写这个方法时，如果没有在方法定义里声明这个参数，Django调用form.save()时就会因为传了一个你没定义的参数而抛出save() got an unexpected keyword argument 'commit'的错误。

怎么解决？ #

你只需要在自定义的save()方法中添加commit=True参数（给它一个默认值，这样既兼容Django的调用逻辑，也允许你灵活调整），然后在方法内部按照Django的标准逻辑处理这个参数：

• 当commit=True时，直接把对象保存到数据库
• 当commit=False时，仅创建模型实例但不保存，留给调用者后续自行处理

错误代码示例 #

假设你原来的代码是这样的（这就是报错的原因）：

from django import forms
from .models import YourModel

class YourModelForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = ['field1', 'field2']
    
    def save(self):
        # 自定义逻辑
        instance = super().save(commit=False)
        instance.custom_field = "自定义内容"
        instance.save()
        return instance

修正后的正确代码 #

from django import forms
from .models import YourModel

class YourModelForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = ['field1', 'field2']
    
    def save(self, commit=True):
        # 先通过基类获取未保存的实例
        instance = super().save(commit=False)
        # 你的自定义处理逻辑
        instance.custom_field = "自定义内容"
        
        # 根据commit参数决定是否保存到数据库
        if commit:
            instance.save()
        return instance

额外注意：多对多关系的处理 #

如果你的表单涉及到多对多字段，当commit=True时，别忘了调用self.save_m2m()来保存多对多关系——因为当commit=False时，基类不会自动处理多对多关联：

def save(self, commit=True):
    instance = super().save(commit=False)
    instance.custom_field = "自定义内容"
    
    if commit:
        instance.save()
        # 保存多对多关系
        self.save_m2m()
    return instance

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