Wagtail技术问题：StreamField嵌套StreamBlock后块值无法渲染

问题场景 #

创建多个自定义StructBlock并整合到继承自StreamBlock的ContentStreamBlock中：

class ContentStreamBlock(blocks.StreamBlock):
    sub_heading = SubHeadingBlock()
    paragraph = RichTextBlock()
    image = ImageBlock()
    quote = QuoteBlock()

    class Meta:
        template = "blocks/content_stream_block.html"

在ContentPage模型中使用该StreamBlock：

class ContentPage(Page):
    body = StreamField([
        ('block', ContentStreamBlock()),
    ], use_json_field=True)
    content_panels = Page.content_panels + [
        FieldPanel('body'),
    ]

渲染页面时，所有元素仅显示结构却无对应值，自定义StructBlock直接放在StreamField下可正常工作，但嵌套到子类化的StreamBlock后失效。模板代码如下：

{% load wagtailcore_tags wagtailimages_tags %}

<div class="mt-16 max-w-2xl">
    <h2>new block</h2>
    {% for blk in block.value %}
        {% include_block blk %}
    {% endfor %}
</div>

问题原因 #

你在ContentPage的StreamField中额外嵌套了一层('block', ContentStreamBlock())，而ContentStreamBlock本身已经是StreamBlock类型。这导致渲染时block.value是包含外层block项的数组，而非直接获取到ContentStreamBlock内部的子块内容，模板遍历的对象层级错误，因此无法正确渲染子块的值。

解决方案 #

方案1：移除多余的嵌套层（推荐） #

修改ContentPage中StreamField的定义，直接将ContentStreamBlock作为StreamField的参数，无需额外包裹元组：

class ContentPage(Page):
    body = StreamField(ContentStreamBlock(), use_json_field=True)
    content_panels = Page.content_panels + [
        FieldPanel('body'),
    ]

模板保持原代码即可正常渲染，此时block.value直接对应ContentStreamBlock内部的子块集合。

方案2：保留嵌套层并修改模板 #

如果必须保留外层的('block', ...)结构，需要调整模板，先取出外层项的value再遍历内部子块：

{% load wagtailcore_tags wagtailimages_tags %}

<div class="mt-16 max-w-2xl">
    <h2>new block</h2>
    {% for outer_block in block.value %}
        {% for blk in outer_block.value %}
            {% include_block blk %}
        {% endfor %}
    {% endfor %}
</div>

内容的提问来源于stack exchange，提问作者S.D.