Wagtail文档链接缺失href属性问题求助

• 检查模板是否加载wagtailcore_tags标签库
  确保使用{{ page.body|richtext }}的模板开头添加了标签库加载语句：

  {% load wagtailcore_tags %}
  

  这是最常见的原因——未加载wagtailcore_tags时，richtext过滤器不会生效，原始富文本内容（含linktype="document"的未处理标签）会直接输出，自然缺失href属性。

• 确认RichTextField的features包含document-link
  检查页面模型中RichTextField的定义，确保features列表包含'document-link'，示例：

  from wagtail.fields import RichTextField
  
  class MyPage(Page):
      body = RichTextField(features=['bold', 'italic', 'document-link'])
  

  若未启用该feature，即使编辑器允许插入文档链接，渲染时的链接转换逻辑也可能无法触发。

• 排查自定义渲染逻辑的干扰
  若项目中自定义了RichText渲染管道（比如修改WAGTAIL_RICHTEXT_FILTERS设置、自定义过滤器），检查是否覆盖了Wagtail默认的文档链接转换逻辑。默认情况下，Wagtail会自动将带linktype="document"和id属性的<a>标签，替换为带正确href的链接。

• 验证文档对象的有效性
  确认数据库中存在ID为2的文档记录。若该文档已被删除，渲染时无法生成有效链接，也可能导致href缺失（部分场景下仅保留原始标签结构）。

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