删除Annonce页面时如何自动删除关联图片？是否需修改模型？

用户提供的模型代码如下：

class AnnoncePage(Page):
    date = models.DateField("Date de publication", blank=True, null=True)
    description = RichTextField(features=['h2', 'h3', 'bold', 'italic', 'link', 'hr', 'ol', 'ul'], blank=True)
    lieu = models.CharField(blank=True, max_length=200)
    surface = models.PositiveSmallIntegerField(blank=True, null=True)
    nb_pieces = models.PositiveSmallIntegerField(blank=True, null=True)
    prix_affiché_index = models.CharField(blank=True, max_length=200, null=True)
    conditions_vente_et_prix = RichTextField(blank=True, features=['h2', 'h3', 'bold', 'italic', 'link', 'hr', 'ol', 'ul'])
    def main_image(self):
        gallery_item = self.gallery_images.first()
        if gallery_item:
            return gallery_item.image
        else:
            return None
    content_panels = Page.content_panels + [
        FieldPanel('date'),
        InlinePanel('gallery_images', label="Gallery images"),
        FieldPanel('lieu', classname="full"),
        FieldPanel('surface', classname="full"),
        FieldPanel('nb_pieces', classname="full"),
        FieldPanel('description', classname="full"),
        FieldPanel('prix_affiché_index', classname="full"),
        FieldPanel('conditions_vente_et_prix', classname="full")
    ]
    promote_panels = []
    settings_panels = []
    max_count = 20

class AnnoncePageGalleryImage(Orderable):
    page = ParentalKey(AnnoncePage, on_delete=models.SET_NULL, related_name='gallery_images', null=True)
    image = models.ForeignKey(
        'wagtailimages.Image', on_delete=models.SET_NULL, related_name='+', null=True
    )
    panels = [
        ImageChooserPanel('image')
    ]

提问：删除该Annonce页面时，如何自动删除其关联的图片？是否需要修改现有模型？

好问题！要实现删除Annonce页面时自动清理关联的图片，我们得先分析现有模型的问题，再选择合适的方案：

现有模型的不足 #

当前的AnnoncePageGalleryImage设置了两个关键的on_delete参数：

• page字段用了on_delete=models.SET_NULL：删除AnnoncePage时，关联的GalleryImage实例不会被删除，只是它们的page外键会被设为null，留下冗余数据。
• image字段用了on_delete=models.SET_NULL：即使GalleryImage实例被删除，关联的Wagtail图片也只会把外键置空，不会删除实际的图片文件。

所以要实现自动删除，我们有两种方案可选：

方案一：修改模型的on_delete参数（简单直接） #

如果这些图片是专属当前AnnoncePage，不会被其他页面复用，那么修改模型是最直接的方式：

class AnnoncePageGalleryImage(Orderable):
    # 修改page字段的on_delete为CASCADE，删除页面时自动删除关联的GalleryImage
    page = ParentalKey(AnnoncePage, on_delete=models.CASCADE, related_name='gallery_images')
    # 修改image字段的on_delete为CASCADE，删除GalleryImage时自动删除对应的Wagtail图片
    image = models.ForeignKey(
        'wagtailimages.Image', on_delete=models.CASCADE, related_name='+'
    )
    panels = [
        ImageChooserPanel('image')
    ]

效果说明 #

• 删除AnnoncePage时，Django会自动级联删除所有关联的AnnoncePageGalleryImage实例。
• 每个AnnoncePageGalleryImage被删除时，对应的wagtailimages.Image（包括服务器上的图片文件）也会被自动删除。

方案二：使用Django信号（灵活可控） #

如果图片可能被其他页面复用，不想因为删除一个AnnoncePage就删掉共享的图片，那么可以用Django的post_delete信号来做精细化处理：

from django.db.models.signals import post_delete
from django.dispatch import receiver
from wagtailimages.models import Image

@receiver(post_delete, sender=AnnoncePage)
def cleanup_associated_images(sender, instance, **kwargs):
    # 遍历当前页面的所有关联图片项
    for gallery_item in instance.gallery_images.all():
        if gallery_item.image:
            # 可选：检查图片是否还有其他引用（避免误删共享图片）
            # 比如查询所有使用该图片的GalleryImage数量
            ref_count = Image.objects.filter(id=gallery_item.image.id).count()
            if ref_count <= 1:
                # 只有当前页面引用时才删除图片
                gallery_item.image.delete()
        # 删除关联的GalleryImage实例（即使page字段是SET_NULL）
        gallery_item.delete()

效果说明 #

• 这个信号会在AnnoncePage被删除后触发，先处理图片（可选检查引用数），再清理冗余的AnnoncePageGalleryImage实例。
• 不需要修改原有模型的on_delete设置，适合需要保留共享图片的场景。

总结：是否需要修改现有模型？ #

• 如果用方案一：需要修改AnnoncePageGalleryImage的两个on_delete参数，这是最简洁的方式。
• 如果用方案二：可以不修改现有模型，但建议把page字段的on_delete改成CASCADE，减少数据库中的冗余空值数据。

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