WagTail将RichText改为StreamField后模板渲染报错如何解决

错误根源 #

• 直接修改共用母模板base.html的逻辑错误：base.html是全站所有页面共用的父模板，你将{% block content %}{% endblock %}硬编码为{% include_block page.body %}后，所有继承该母模板的页面都会强制渲染page.body，但博客列表页、其他普通页面并没有对应body字段的渲染逻辑，自然会导致列表内容无法正常展示。
• 原报错的触发原因：你未修改base.html时，单篇博文模板blog_page.html中使用了{{ page.body|richtext }}过滤器，该过滤器仅支持处理字符串格式的富文本内容，现在body字段改为StreamField后，返回值是StreamValue类型，和过滤器要求的输入类型不匹配，所以抛出类型错误。

正确操作步骤 #

1. 首先恢复base.html的原有代码，保留原生的{% block content %}{% endblock %}定义，不要在全局母模板中写仅适用于单页的渲染逻辑。
2. 找到单篇博文的专属模板blog_page.html，定位到原来渲染body字段的代码行：

{{ page.body|richtext }}

将其替换为StreamField专用的渲染标签即可：

{% include_block page.body %}

修改完成后，单篇博文的StreamField内容可以正常渲染，同时博客列表页等其他页面的content块内容也不会被覆盖，可正常展示。

注：如果你的项目已有存量的旧博文数据，将RichText改为StreamField后旧数据可能丢失，修改字段前请提前做好数据备份和迁移处理。

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