Wagtail中渲染子页面StreamField内StructBlock问题求助

嘿，我刚接触Wagtail的时候也遇到过几乎一模一样的问题！别着急，咱们一步步排查最常见的几个原因：

1. 确保你拿到的是具体的子页面实例 #

这是新手最容易踩的坑！page.get_children()默认返回的是通用的Page对象，而不是你自定义的DefinitionPage。通用Page对象没有你定义的body字段，所以就算模板里写了post.body，也拿不到内容——但title是Page自带的字段，所以能正常显示。

解决方法：在获取子页面的时候加上.specific（或者.specific(defer=True)优化性能）：

{% for post in page.get_children.specific %}
    <h2>{{ post.title }}</h2>
    {% for block in post.body %}
        {% include_block block %}
    {% endfor %}
{% endfor %}

2. 检查DefinitionPage模型的配置 #

确认你的模型里正确定义了body字段，并且把它加到了content_panels里（不然后台编辑页面根本看不到这个字段，没法填内容）：

from wagtail.core.models import Page
from wagtail.core.fields import StreamField
from wagtail.core.blocks import StructBlock, CharBlock, RichTextBlock

class DefinitionPage(Page):
    body = StreamField([
        ('definition', StructBlock([
            ('term', CharBlock(label="术语")),
            ('description', RichTextBlock(label="描述")),
        ])),
        # 其他区块类型...
    ])

    # 一定要把body加到content_panels里！
    content_panels = Page.content_panels + [
        FieldPanel('body'),
    ]

3. 确认模板标签已加载 #

{% include_block %}是Wagtail提供的模板标签，必须在模板开头加载wagtailcore_tags才能生效：

{% load wagtailcore_tags %}

<!-- 下面才是你的页面内容 -->
{% for post in page.get_children.specific %}
    ...
{% endfor %}

4. 自定义StructBlock模板的坑 #

如果你给StructBlock指定了自定义模板，要注意模板里的变量是self而不是block！比如你的自定义模板blocks/definition_block.html应该这么写：

<div class="definition-item">
    <h3>{{ self.term }}</h3>
    {{ self.description|richtext }}
</div>

同时模型里要正确指定模板路径：

('definition', StructBlock([
    ('term', CharBlock()),
    ('description', RichTextBlock()),
], template='blocks/definition_block.html'))

5. 最后检查：内容真的保存了吗？ #

进入Wagtail的页面编辑器，打开对应的DefinitionPage，确认body字段里确实添加了区块，并且点击了保存按钮。有时候可能编辑完忘了保存，或者保存过程中出错了，导致数据库里没有内容。

按照上面的步骤排查下来，应该就能解决问题啦！

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