Django网站分页时出现NoReverseMatch错误的原因排查

1. 缺失URL命名空间 #

你的urls.py中设置了app_name = "clubs"，这意味着模板中使用{% url %}标签时必须指定命名空间，否则Django无法定位到正确的URL配置。

2. URL未适配分页参数传递 #

当前club-list的URL路径是path('', ...)，没有预留分页参数的位置，直接把页码作为路径参数传递会导致反向解析失败。而Django的ListView默认支持通过GET参数（即?page=X）传递分页页码，这种方式无需修改URL配置，是更通用的分页实现方案。

完整修复后的分页模板代码 #

{% block pagination %}
    {% if page_obj.has_previous %}
        <a href="{% url 'clubs:club-list' %}?page={{ page_obj.previous_page_number }}">
            Previous Page
        </a>
    {% endif%}
    {% if page_obj.has_next %}
        <a href="{% url 'clubs:club-list' %}?page={{ page_obj.next_page_number }}">
            Next Page
        </a>
    {% endif%}
{% endblock %}

额外验证点 #

• 确认模板继承的基础模板中存在pagination区块，否则分页代码无法被渲染
• 检查Club模型的get_absolute_url方法是否正确实现（虽不影响当前分页错误，但关系到详情页跳转）

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