Django新增slug字段后模板渲染报product_detail反向解析NoReverseMatch错误

NoReverseMatch异常的本质是模板反向解析product_detail命名路由时，传入的参数数量、值类型，和路由表中注册的同名路由实际要求的参数完全不匹配。
结合给出的报错信息拆解错位点：

• 模板执行反向解析时传入了2个参数：整数1、字符串'sgm'，说明模板预期这个详情路由需要接收两段路径参数
• 但Django在路由表中匹配到的product_detail命名路由，仅定义了1个字符串类型的category_slug参数（对应匹配规则(?P<category_slug>[-a-zA-Z0-9_]+)$），既没有预留第二个参数位，也无法接收整数类型的入参

触发这个错位的直接原因都是添加slug字段后修改配置时的常见疏漏：

• 给模型添加slug字段后，调整详情页路由时漏配了商品维度的slug路径参数
• 路由的name属性配置错误，把分类列表的路由错误绑定了product_detail的名称，真正的详情页路由没有正确关联这个name
• 模板中{% url %}标签的传参顺序、参数值，和路由定义的参数规则不匹配

1. 核对shop/urls.py中的路由定义
   完成slug字段迁移后，详情页路由需要同时预留分类slug、商品slug两个路径参数位，正确配置示例：

   # shop/urls.py
   from django.urls import path
   from . import views
   
   # 配置应用命名空间，避免多应用下路由重名冲突
   app_name = 'shop'
   
   urlpatterns = [
       # 商品列表页路由
       path('', views.product_list, name='product_list'),
       # 商品详情页路由：匹配两段路径，分别对应分类slug、商品slug
       path('<slug:category_slug>/<slug:product_slug>/', views.product_detail, name='product_detail'),
   ]
   

   你之前的配置疏漏大概率是详情页路由漏写了<slug:product_slug>/段，或是错把列表页路由的name写成了product_detail，导致Django匹配到的路由规则和预期不符。
2. 核对项目根路由的挂载配置
   确保项目根目录的urls.py中，正确将shop应用的路由包含进全局路由表，不会出现路由拦截顺序错位：

   # 项目根urls.py
   from django.urls import path, include
   
   urlpatterns = [
       path('', include('shop.urls')),
   ]
   

3. 修正模板中的url反向解析写法
   如果配置了应用命名空间，模板中写url时需要带上命名空间前缀，且传入的参数顺序要和路由定义的参数顺序完全匹配，list.html中的正确写法参考：

   {% for product in products %}
       <a href="{% url 'shop:product_detail' product.category.slug product.slug %}">
           {{ product.name }}
       </a>
   {% endfor %}
   

   注意不要传入和参数类型不匹配的值：比如路由参数定义的是slug字符串，就不要传整数类型的商品ID，否则也会触发匹配失败。
4. 本地验证解析正确性
   可以进入Django Shell手动测试反向解析，确认配置无误：

   # Shell内执行测试代码
   from django.urls import reverse
   # 替换为实际的分类slug、商品slug测试
   print(reverse('shop:product_detail', args=('electronics', 'wireless-mouse')))
   

   可以正常输出完整路径时，模板渲染的报错就会消除。

内容的提问来源于stack exchange，提问作者محمد رحمت الله رحمانى