如何为Django的M2M字段添加through属性并保留related manager的.add()功能？

我之前刚好踩过这个坑！其实核心问题是：当你给M2M字段加了through模型后，Django默认的.add()方法不会自动处理额外的字段——哪怕这个字段是可为空的，它也不会主动填充None，所以才会报错。下面给你两个实用的解决办法，都能让.add()和.remove()像没加through时一样正常工作：

方法一：给Through模型的额外字段设默认值 #

这是最简单的方案，直接给你的可为空字段加上default=None：

from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)

class Author(models.Model):
    name = models.CharField(max_length=100)
    books = models.ManyToManyField(Book, through='BookAuthor')

# 带额外可为空字段的Through模型
class BookAuthor(models.Model):
    book = models.ForeignKey(Book, on_delete=models.CASCADE)
    author = models.ForeignKey(Author, on_delete=models.CASCADE)
    # 这里加上default=None，让Django自动填充
    notes = models.TextField(null=True, blank=True, default=None)

这样调用author.books.add(book)时，Django会自动用None填充notes字段，完全不需要额外处理。如果之后你需要给这个字段传特定值，依然可以用through_defaults参数覆盖：

author.books.add(book, through_defaults={'notes': '这是一本经典著作'})

方法二：重写M2M管理器的.add()方法 #

如果你不想给字段加默认值，或者需要更灵活的控制，可以自定义一个M2M管理器，重写.add()方法来自动填充空字段：

from django.db.models.fields.related import ManyToManyManager

class CustomM2MManager(ManyToManyManager):
    def add(self, *objs, through_defaults=None, **kwargs):
        # 如果没传through_defaults，自动给额外字段设为None
        through_defaults = through_defaults or {'notes': None}
        super().add(*objs, through_defaults=through_defaults, **kwargs)
    
    # .remove()方法不需要额外处理，Django会直接删除关联记录
    def remove(self, *objs, **kwargs):
        super().remove(*objs, **kwargs)

然后在你的M2M字段里指定这个管理器：

class Author(models.Model):
    name = models.CharField(max_length=100)
    books = models.ManyToManyField(Book, through='BookAuthor', manager=CustomM2MManager)

这样每次调用.add()时，只要没传through_defaults，就会自动把notes设为None，完美兼容原来的使用习惯。

为什么会出现这个问题？ #

说穿了就是Django的ORM设计逻辑：当你使用through模型扩展M2M时，ORM会认为你需要手动处理所有额外字段——哪怕字段允许为空，它也不会主动帮你填充None，而是直接尝试插入一条缺少该字段值的记录，最终触发数据库层面的错误（哪怕字段允许为空，有些数据库对“未指定值”和“指定为NULL”的处理是有区别的）。

上面两种方法本质都是让Django在创建through模型实例时，自动给额外的可为空字段填充None，从而和原生M2M的行为保持一致。

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