Wagtail中ParentalManyToManyField修改无法保存的原因分析

问题原因 #

你在Orderable模型中使用了普通的FieldPanel来渲染ParentalManyToManyField，但Wagtail的ParentalManyToManyField（尤其是作为集群子模型的字段）需要用专门的ParentalManyToManyPanel来处理数据保存。普通FieldPanel无法适配Wagtail的父-子集群模型保存机制，导致勾选的关联关系无法被持久化；而普通字符字段name不受影响，是因为它不需要处理复杂的关联逻辑。

解决方案 #

导入Wagtail的ParentalManyToManyPanel，替换掉原来的FieldPanel即可。修改后的代码如下：

from django import forms
from django.db import models
from wagtail.models import ClusterableModel, Orderable
from wagtail.admin.panels import FieldPanel, ParentalManyToManyPanel  # 引入ParentalManyToManyPanel

class Partner(ClusterableModel):
    name = models.CharField(max_length=255)

class Partnership(Orderable):
    name = models.CharField(max_length=255)
    partners = ParentalManyToManyField(
        "partners.Partner",
        related_name="partnerships",
        blank=True,
    )

    panels = [
        FieldPanel("name"),
        # 替换为ParentalManyToManyPanel，保留CheckboxSelectMultiple组件
        ParentalManyToManyPanel("partners", widget=forms.CheckboxSelectMultiple),
    ]

ParentalManyToManyPanel是Wagtail为集群模型关联字段设计的专用面板，它能正确触发关联数据的保存流程，确保勾选或取消的关联关系被持久化到数据库中。

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