Django产品列表点击跳转详情页报NoReverseMatch与TypeError

第一阶段：初始NoReverseMatch错误 #

这个错误的逻辑非常直接：你定义的product_details路由是强依赖id参数的，规则要求路径必须是product_details/加整数id才能匹配。最开始你在产品列表页生成跳转链接时，没有把当前遍历的产品id作为参数传给url反向解析方法，Django找不到不需要传参就能匹配的product_details路由规则，就会抛出这个错误。
你后续补充product.id作为url参数的修复方向是正确的，解决了第一阶段的路由匹配问题。

第二阶段：补充id参数后的TypeError错误 #

这个错误的本质是视图函数和路由的传参规则没对齐：
当Django接收到/product_details/1的请求时，会按照路由里定义的参数捕获规则，把路径里拿到的1，以关键字参数id=1的形式传给product_details视图函数。但Django在检查函数签名时发现，你定义的product_details函数的形参列表里，根本没有声明要接收id这个参数，相当于函数被传了一个它没准备接收的参数，就触发了这个类型错误。
新手在这个环节最容易踩的三个坑：

• 写视图时漏了形参：很多人写product_details时，只写了def product_details(request):，完全忘了要把路由要求的id参数加到函数形参列表里，以为路由传的参数能直接在函数里用，其实必须显式声明才能接住。
• 代码缩进错误：你贴出来的视图代码所有函数体都没有缩进，Python解释器会判定函数定义到第一行就结束了，后面的查询、渲染代码都跑到了全局模块作用域里，实际运行的函数和你预期写的函数根本不是同一个版本。
• 模板冗余写法：你模板里的{% endfor product %}是多余的，Django的for循环结束标签不需要传循环变量，正确写法是直接写{% endfor %}，多余的参数虽然不会直接报错，但属于不规范写法。

修正后的可运行代码对照 #

把所有易出错的点修正后，三个核心文件的正确写法可以逐一核对：

views.py #

from django.shortcuts import render, get_object_or_404
from .models import Product

def products1(request):
    products = Product.objects.all()
    context = {'products': products}
    return render(request, 'shopping_app/products1.html', context)

# 形参必须显式声明id，和路由的参数名完全对应
def product_details(request, id):
    # 明确把id作为查询条件传入，避免位置参数的语义歧义
    product = get_object_or_404(Product, id=id)
    context = {'product': product}
    return render(request, 'shopping_app/product_details.html', context)

urls.py #

# 路由末尾加斜杠，和Django默认URL风格保持一致
path('products1/', views.products1, name='products1'),
path('product_details/<int:id>/', views.product_details, name='product_details'),

products1.html 产品列表模板 #

{% for product in products %}
<div class="w-52 text-left text-xs">
    <a href="{% url 'product_details' product.id %}">
        <img class="pb-2" src="{{ product.imageURL }}">
        <h4 class="opacity-90">{{product.name}}</h4>
        <span class="opacity-80">₦{{product.price|floatformat:2}}</span>
    </a>
</div>
{% endfor %}

改完后的排查清单 #

如果修改后还是报错，按顺序检查：

• 确认所有改动的文件都已经保存，没有写了代码没保存导致运行旧版本的情况
• 检查项目里有没有重复定义product_details的路由规则，覆盖了当前正确的配置
• 确认主urls.py文件中已经正确通过include()引入了当前应用的路由配置，没有出现路由没加载的问题

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