Wagtail中save()方法添加ParentalManyToManyField关联不生效问题

核心问题 #

1. 递归调用save()导致逻辑混乱：你在循环里调用self.save()，会反复触发save方法，干扰父类的保存流程，且此时页面可能未完成持久化，关联无法正确写入数据库。
2. ParentalManyToManyField的依赖条件：Wagtail的ParentalManyToManyField要求页面实例必须已拥有主键（完成首次保存）才能建立关联。如果是新建页面，在父类save前调用self.products.add()，页面还没有主键，关联无法被持久化。
3. update_fields判断限制：仅当update_fields存在时才执行逻辑，会导致新建页面（通常不带update_fields）时关联逻辑不触发。

修正后的代码 #

# Models
class BlogProduct(models.Model):
    product_id = models.CharField(max_length=10, blank=False, null=False)

    def __str__(self):
        return self.product_id  # 建议添加，方便调试查看

class ProductBlogPage(BlogDetailPage):
    products = ParentalManyToManyField('blog.BlogProduct', blank=True)

    product_details = StreamField(COMMON_BLOCKS + [
        ('product_name', blocks.ProductNameBlock()),
    ],
        null=True, 
        blank=True,
        use_json_field=True,
    )

    def save(self, *args, **kwargs):
        # 先调用父类save，确保页面实例完成持久化、拥有主键
        super().save(*args, **kwargs)
        
        # 可选：清空现有关联，避免重复添加（根据业务需求调整）
        # self.products.clear()
        
        for product in self.product_details.raw_data:
            # 建议从product数据中获取真实product_id，而非硬编码'test1'
            blog_product, _ = BlogProduct.objects.get_or_create(product_id='test1')
            # 此时页面已有主键，add操作会直接写入数据库
            self.products.add(blog_product)
        
        # 调试用打印（可删除）
        print(self.products.all())

关键修改说明 #

• 先执行父类save：确保页面实例完成持久化，拥有合法主键，此时ParentalManyToManyField的关联才能被正确保存到数据库。
• 移除递归save调用：self.products.add()本身会自动处理关联的保存，无需额外调用页面的save，避免循环触发逻辑。
• 去掉update_fields判断：确保新建页面时也能执行关联逻辑；若需仅在更新特定字段时执行，可调整为检查update_fields是否包含product_details。
• 可选清空旧关联：如果每次保存都要根据product_details重新生成关联，先调用self.products.clear()可避免重复添加同一关联。

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