Django出现NoReverseMatch错误，配置对应路由name仍触发报错

解决方案 #

以下是针对性的排查和修复步骤，按优先级依次操作：

1. 检查根路由是否注册了当前App的路由 #

大部分此类问题都是因为没有在项目根目录的urls.py中引入App的路由配置，示例正确配置如下（假设你的App名为tractor）：

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    # 必须添加该行引入你的App路由
    path('', include('tractor.urls')),
]

如果你在引入时指定了namespace，比如path('', include('tractor.urls', namespace='tractor'))，那么模板中调用路由时需要加上命名空间前缀：

{% url "tractor:post-detail-page" slug=post.slug %}

2. 给路由添加末尾斜杠 #

Django默认开启APPEND_SLASH配置，路由末尾缺斜杠可能导致反向匹配失败，修改App下urls.py的对应配置：

# 原来的写法
# path("posts/<slug:slug>",views.post_detail,name="post-detail-page"),
# 修改后加末尾斜杠
path("posts/<slug:slug>/",views.post_detail,name="post-detail-page"),

3. 确认Post实例的slug字段有有效值 #

如果存在Post实例的slug字段为空、或包含不符合slug规则的特殊字符，也会触发反向匹配错误。你可以在singlepost.html中加入调试代码先验证slug输出是否正常：

<!-- 加在a标签前面调试，确认有值后删除即可 -->
<p>调试slug：{{ post.slug }}</p>

4. 显式传递模板变量 #

引入子模板时显式传递post变量，避免变量作用域异常：

<!-- 修改all-post.html中的include语句 -->
{% include "tractor/includes/singlePost.html" with post=post %}

额外注意事项 #

你当前post_detail视图中渲染的模板路径为blog/post-detail.html，和其他视图的tractor/开头的模板路径不一致，解决反向匹配问题后大概率会报模板不存在错误，记得修改为你实际存放详情页模板的路径。

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