Django Wagtail项目搜索页'str'无'relative_url'属性错误及上下文传参问题

AttributeError 报错根因 #

• routablepageurl 模板过滤器要求第一个参数必须是RoutablePageMixin的实际页面实例（即NewsIndexPage对象），这类Page对象内置relative_url方法用于生成可访问的路由地址。
• 搜索视图是独立注册的普通Django视图，并未挂载在Wagtail页面树路由体系下，因此不会自动触发NewsIndexPage的get_context方法，返回的模板上下文从未定义news_page变量。
• Django模板渲染规则中，未定义的变量会自动替换为空字符串（str类型），当routablepageurl拿到空字符串作为第一个参数时，会尝试调用str类型不存在的relative_url方法，触发报错。

字段渲染异常根因 #

• 模板渲染流程在routablepageurl标签处就抛出错误中断，后续的文章描述、日期、配图相关代码完全没有执行渲染，仅循环结构上层的文章标题因位置靠前被正常输出。
• 即使排除报错，配图的原生写法存在逻辑错误：通过{% image result.blog_image max-770x480 as blog_img %}预生成了适配尺寸的图片对象，但img标签的src直接绑定{{ result.blog_image }}——该值是Wagtail Image对象的字符串表示，并非可访问的图片资源URL，无法正常加载。

1. 修正搜索视图的上下文传递 #

手动从数据库取出NewsIndexPage实例，注入到模板上下文中，填补缺失的news_page变量：

• 先在视图文件中导入NewsIndexPage模型
• 修改视图的返回上下文逻辑：

from news.models import NewsPage, NewsCategory, NewsIndexPage

def search(request):
    posts = NewsPage.objects.live().public()
    categories = NewsCategory.objects.all()
    # 获取站点内已发布的NewsIndexPage实例，作为路由生成的依赖对象
    news_index_page = NewsIndexPage.objects.live().first()

    # 原有搜索逻辑、分页逻辑保持不变
    search_query = request.GET.get('q', None)
    if search_query:
        search_results = NewsPage.objects.live().search(search_query)
        Query.get(search_query).add_hit()
        reversenews = list(reversed(search_results))
        paginator = Paginator(reversenews, 16)
        page = request.GET.get('page')
        try:
            search_results = paginator.page(page)
        except PageNotAnInteger:
            search_results = paginator.page(1)
        except EmptyPage:
            search_results = paginator.page(paginator.num_pages)
    else:
        search_results = NewsPage.objects.none()

    return render(request, 'search/search.html', {
        'search_query': search_query,
        'search_results': search_results,
        'recent_posts' : posts,
        'categories' : categories,
        # 注入news_page，供routablepageurl标签调用
        'news_page': news_index_page
    })

注意：若站点存在多个NewsIndexPage，需根据实际页面路径获取对应实例，避免错拿无关页面。

2. 修正模板的字段渲染逻辑 #

• 替换错误的图片绑定写法，使用{% image %}标签生成的资源URL：

<!-- 原错误写法 -->
{% image result.blog_image max-770x480 as blog_img  %}
<a class="images" href="{% pageurl result %}" title="images">
  <img  src="{{result.blog_image}}" alt="images">
</a>

<!-- 修正后写法 -->
{% image result.blog_image max-770x480 as blog_img  %}
<a class="images" href="{% pageurl result %}" title="images">
  <img src="{{ blog_img.url }}" alt="{{ result.image_description }}">
</a>

• 对于StreamField类型的description字段，只要渲染流程正常，{{ result.description }}会自动输出对应块的渲染HTML，无需额外处理。

3. 增加模板容错逻辑 #

在分类链接生成位置增加判空，避免NewsIndexPage缺失时再次触发报错：

{% for cat in result.categories.all %}
  {% if news_page %}
    <a href="{% routablepageurl news_page 'category_view' cat.slug %}" style="color:white">{{cat.name}}</a>
  {% endif %}
{% endfor %}

冗余优化建议 #

• 删除模板中重复加载的标签库（多次重复{% load wagtailcore_tags %}、{% load static %}，仅需保留一次即可）
• 修正未找到结果时的静态资源引用错误：原代码{% static '/images/not_found %}存在标签未闭合、路径前加多余斜杠的问题，应改为{% static 'images/not_found.png' %}

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