Django中add方法报错"RelatedManager.add() got multiple values for argument"如何解决？

问题现象与错误背景

当开发者使用Django的add()方法向ManyToManyField或ForeignKey关系添加对象时，经常会遇到类似以下的报错：

TypeError: RelatedManager.add() got multiple values for argument 'pk'

这个错误通常发生在以下场景：

在Django的ORM体系中，RelatedManager的add方法设计遵循特定参数规范：

典型错误代码示例：

# 错误用法
article.tags.add(tag_instance, pk=tag_instance.id)

保持参数传递方式的一致性，要么全部使用位置参数，要么全部使用关键字参数：

# 正确用法 - 位置参数
article.tags.add(tag_instance)

# 正确用法 - 关键字参数
article.tags.add(pk=tag_instance.id)

当需要批量添加时，使用*操作符展开可迭代对象：

tag_ids = [1, 2, 3]
article.tags.add(*Tag.objects.filter(id__in=tag_ids))

对于大量记录的关联创建，考虑使用bulk_create：

new_tags = [Tag(name=f"tag_{i}") for i in range(100)]
created_tags = Tag.objects.bulk_create(new_tags)
article.tags.add(*created_tags)

验证模型关系定义是否正确，特别是related_name和through参数：

class Article(models.Model):
    tags = models.ManyToManyField(
        'Tag',
        through='ArticleTag',
        related_name='articles'
    )

对于自定义中间表的情况，直接操作中间模型：

ArticleTag.objects.create(
    article=article_instance,
    tag=tag_instance,
    created_at=timezone.now()
)

开发者常犯的错误包括：

有效的调试方法：