如何在Django中自定义ManyToManyField反向关联名称？

问题背景 #

我定义了如下Django模型关系：

class Item(models.Model):
    pass

class Category(models.Model):
    items = models.ManyToManyField(Item)

目前可以通过category.items访问Category的关联Item集合，但希望在Item模型中用item.categories替代默认的反向关联名称（默认是category_set）来访问关联的分类，该如何实现？

尝试后的问题 #

我尝试修改多对多字段的定义，添加related_name参数：

items = models.ManyToManyField(Item, related_name="categories")

但执行Item.objects.create(**data)创建对象时，出现了以下错误：

TypeError: Direct assignment to the reverse side of a many-to-many set is prohibited. Use categories.set() instead.

解决方案 #

1. 自定义反向关联名称的方法是正确的
   使用related_name="categories"的写法完全符合Django规范，设置完成后，你可以通过item.categories访问该Item关联的所有Category对象，这一步没有问题。

2. 解决创建时的赋值错误
   出现上述错误的核心原因：多对多关系的反向字段（这里的categories）无法在创建对象时直接赋值。因为调用create()时，Item对象还未被保存到数据库，此时无法建立多对多的关联关系。

   正确的操作需要分成两步：

   • 第一步：创建并保存Item对象，排除data中与categories相关的键值对

     # 过滤掉categories字段，先创建Item
     item_data = {key: value for key, value in data.items() if key != "categories"}
     item = Item.objects.create(**item_data)
     

   • 第二步：使用set()方法为已保存的Item设置关联的分类

     # 如果data中包含categories，就设置关联
     if "categories" in data:
         item.categories.set(data["categories"])
     

   你也可以先实例化Item对象再保存，之后设置关联，效果一致：

   item_data = {key: value for key, value in data.items() if key != "categories"}
   item = Item(**item_data)
   item.save()
   item.categories.set(data["categories"])
   

   注意：set()方法既可以接收Category对象的列表，也可以接收分类ID的列表，Django会自动处理关联逻辑。

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