Wagtail遍历ClusterTaggableManager标签获取关联内容报错解决

我之前也碰到过类似的坑，咱们来一步步拆解问题和解决办法：

为什么之前的代码会报错？ #

• 第一个错误 '_ClusterTaggableManager' object is not iterable：因为self.tags是ClusterTaggableManager的实例，不是直接可迭代的列表/查询集，你得调用它的方法来获取实际的标签集合。
• 第二个错误 '_ClusterTaggableManager' object has no attribute 'get_query_set'：get_query_set()是django-taggit旧版本的方法，新版本已经改用.all()来获取标签查询集了。

正确的实现代码 #

直接把遍历部分改成self.tags.all()就能解决迭代问题，另外还可以优化一下去重逻辑（避免同一个内容被多个标签重复添加）：

def get_related_content(self):
    related_content = []
    # 获取当前页面的所有标签查询集
    tags = self.tags.all()
    if tags:
        for tag in tags:
            # 筛选带相同标签的BlogDetailPage（注意用tag.name匹配）
            related_content.extend(BlogDetailPage.objects.live().filter(tags__name=tag.name))
            # 筛选带相同标签的OfferDescription
            related_content.extend(OfferDescription.objects.live().filter(tags__name=tag.name))
        # 去重：用字典按页面pk作为键，自动覆盖重复项，再转成列表
        related_content = list({item.pk: item for item in related_content}.values())
    return related_content

额外说明 #

• 用tag.name而不是直接传tag：因为Tag对象默认匹配的是id，用name更符合你“按标签名称匹配”的需求。
• 去重逻辑：如果一个页面同时匹配多个当前页面的标签，会被多次加入列表，用字典按主键去重是最稳妥的方式，保证每个页面只出现一次。

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