Django多图展示项目NoReverseMatch路由错误的排查与修复

触发NoReverseMatch的核心原因是urls.py中混用了Django新旧两套路由语法：

• 当前使用的url()是基于正则表达式匹配的旧版路由API，不支持<int:id>这种路径转换器语法——在正则匹配规则里，<int:id>只是普通字符串，不会被识别为整数参数捕获规则
• 当模板执行{% url 'detail' post.id %}做反向解析时，系统会拿已注册的路由模式做匹配，发现注册的detail路由本质是匹配字面量<int:id>/路径，根本不接收整数参数，自然抛出“参数(1,)未匹配到对应模式”的错误
• 错误堆栈指向base.html是模板继承机制的显示问题，实际触发异常的代码是blog.html中生成详情页链接的模板标签。

1. 替换路由定义为正确写法 #

直接修改项目根目录下的urls.py，移除旧版url()的混用写法，统一使用Django 2.0+推荐的path()语法：

# 替换原有导入逻辑
from django.urls import path
from django.contrib import admin
from django.conf import settings
from django.conf.urls.static import static
from posts import views

urlpatterns = [
    path('youadmin/', admin.site.urls),
    path('', views.blog_view, name='blog'),
    # 替换原错误的路由定义
    path('<int:id>/', views.detail_view, name='detail'),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

如果你坚持使用旧版url()正则路由，对应的detail路由需要写成正则捕获格式，不能混用路径转换器语法：
url(r'^(?P<id>[0-9]+)/$', views.detail_view, name='detail')

2. 修正代码中潜在的运行时问题 #

改完路由后，剩余代码还存在几个会导致后续报错的问题，一并修正：

• 修正blog.html中Post主图的渲染逻辑：因为Post模型的image字段允许为空，直接访问post.image.url会在无图的记录上抛出属性错误，替换为带判断的写法：

  {% if post.image %}
  <img class="card-img-top" src="{{post.image.url}}" alt="文章主图">
  {% else %}
  <div class="card-img-top bg-secondary d-flex align-items-center justify-content-center" style="height:200px">暂无封面图</div>
  {% endif %}
  

• 修正detail.html中轮播图的硬编码问题：当前轮播图全部使用固定外部占位地址，替换为实际上传的图片地址：

  <img
    src="{{ p.image.url }}"
    class="d-block w-100"
    alt="轮播图片"
  />
  

改完后重启本地开发服务，访问首页即可正常加载文章列表，点击“Read More”按钮可以正常进入详情页，不会再抛出NoReverseMatch错误。

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