Wagtail中如何在保存时将StreamField转换为字典？

在Wagtail里，StreamField对应的StreamValue对象直接打印时会自动渲染成HTML，这就是你看到输出是HTML的原因。要获取它的结构化数据，别直接操作self.product_details，而是用它的stream_data属性——这才是存储原始块数据的列表结构，每个元素都是包含块类型和对应值的字典，完全可以直接序列化或处理。

具体实现示例 #

在ProductBlogPage的save方法里可以这么写：

def save(self, *args, **kwargs):
    # 获取StreamField的原始结构化数据
    product_raw_data = self.product_details.stream_data
    
    # 直接把数据转成JSON
    import json
    product_json = json.dumps(product_raw_data)
    
    # 也可按需进一步处理数据，比如提取特定字段
    processed_items = []
    for block in product_raw_data:
        if block["type"] == "product_item":
            item_data = block["value"]
            processed_items.append({
                "name": item_data["product_name"],
                "price": item_data["product_price"],
                "stock": item_data.get("product_stock", 0)
            })
    
    # 必须调用父类的save方法完成页面保存
    super().save(*args, **kwargs)

报错原因说明 #

你直接给json模块传入StreamValue对象，它无法识别这个Wagtail自定义类，自然会抛出类型错误。而stream_data是标准的Python列表+字典结构，完全符合JSON序列化的要求，不会出现此类问题。

补充提示 #

如果你的StreamField包含嵌套块，stream_data里的value字段也会是对应的嵌套字典结构，无需额外处理就能直接使用。要是需要更贴近API返回格式的结构化数据，还可以调用每个块的get_api_representation()方法，但日常场景下stream_data已经足够满足需求。

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