Django CMS含ManyToManyField页面发布后不显示问题求助

问题背景 #

开发ProductCarrossel CMS插件时，关联的ManyToManyField数据在编辑页面正常展示，但页面发布后插件内容完全消失。已尝试清理缓存、删除并重新添加插件，问题未解决。

相关代码 #

模型代码 #

from django.db import models
from cms.models.pluginmodel import CMSPlugin
from myapp.models import Product

class ProductCarrossel(CMSPlugin):
    title = models.CharField(max_length=255)
    products = models.ManyToManyField(Product, related_name='carrossels')

    def __str__(self):
        return self.title

CMS插件代码 #

from cms.plugin_base import CMSPluginBase
from cms.plugin_pool import plugin_pool
from django.utils.translation import gettext_lazy as _
from .models import ProductCarrossel

class ProductCarrosselPlugin(CMSPluginBase):
    model = ProductCarrossel
    name = _("Product Carousel")
    render_template = "plugins/product_carousel.html"

    def render(self, context, instance, placeholder):
        context = super().render(context, instance, placeholder)
        context['products'] = instance.products.all()
        return context

效果截图 #

• 编辑页正常展示：
• 发布页无插件内容：

排查与解决步骤 #

1. 禁用插件缓存 #

Django CMS默认会缓存插件渲染结果，ManyToManyField关联数据的更新可能未触发缓存失效，导致发布页显示空数据。在插件类中添加cache = False测试：

class ProductCarrosselPlugin(CMSPluginBase):
    # ... 原有配置
    cache = False  # 临时禁用缓存验证问题

如果解决问题，可后续配置更精细的缓存策略（如cache_timeout），或关联数据更新时手动清除插件缓存。

2. 确认发布时关联数据已被序列化 #

Django CMS发布页面时会对插件数据做快照，ManyToManyField可能未被正确包含。可在插件的save_model方法中显式处理关联数据：

def save_model(self, request, obj, form, change):
    super().save_model(request, obj, form, change)
    # 确保关联产品被保存到插件实例
    obj.products.set(form.cleaned_data.get('products', []))

3. 检查模板渲染逻辑 #

确认模板中正确遍历products变量，且处理了空数据场景：

<!-- templates/plugins/product_carousel.html -->
<div class="product-carousel">
    <h3>{{ instance.title }}</h3>
    {% for product in products %}
        <div class="carousel-item">{{ product.name }}</div>
    {% empty %}
        <p>No products available.</p>
    {% endfor %}
</div>

若发布页显示No products available，说明渲染时products查询集为空，需检查：

• render方法中是否正确调用instance.products.all()
• 关联的Product模型是否有发布状态限制（如仅已发布产品可在前台显示）

4. 调试上下文数据 #

在模板中临时添加调试代码，查看发布页的上下文内容：

<!-- 调试用，调试完成后删除 -->
<pre>Instance: {{ instance|pprint }}</pre>
<pre>Products Count: {{ products.count }}</pre>

通过输出确认instance是否存在，以及products的数量，定位是数据未传递还是查询结果为空。

5. 检查Django CMS版本兼容性 #

部分旧版本Django CMS在处理ManyToManyField的序列化时存在bug，尝试升级到最新稳定版本，同时确保Django版本与CMS版本兼容。

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