Django分类商品列表页无法加载，报category_id参数缺失错误

问题概述 #

开发分类商品列表功能时，访问http://127.0.0.1:8000/category-product-list页面抛出TypeError，错误提示：category_product_list() missing 1 required positional argument: 'category_id'。

错误原因分析 #

1. URL参数缺失：urls.py中定义的category-product-list路径要求携带<int:category_id>参数，但实际访问的URL未传递该参数，导致Django无法匹配到对应视图的参数要求。
2. 视图参数必填：视图category_product_list将category_id设为必填参数，无参数调用时直接触发类型错误。
3. 模板URL解析错误：HTML模板中使用{% url 'category-product-list' category.pk=category_id %}的语法错误，且上下文未正确传递参数值，可能生成无效链接。

修复步骤 #

1. 确保访问URL携带分类ID #

直接访问带有效分类ID的URL，例如：

http://127.0.0.1:8000/category-product-list/1

（其中1为数据库中实际存在的分类主键ID）

2. 修复视图函数（可选：支持无参数访问） #

如果需要支持“显示所有商品”的场景，可将category_id设为可选参数：

# Views.py
def category_product_list(request, category_id=None):
    if category_id:
        category = Category.objects.get(pk=category_id)
        data = Product.objects.filter(category=category).order_by('-id')
        page_title = f"分类商品：{category.title}"
    else:
        data = Product.objects.all().order_by('-id')
        page_title = "全部商品"
    
    categories = Product.objects.distinct().values('category__title', 'category__id')
    brands = Product.objects.distinct().values('brand__title', 'brand__id')
    colors = ProductAttribute.objects.distinct().values('color__title', 'color__id', 'color__color_code')
    sizes = ProductAttribute.objects.distinct().values('size__title', 'size__id')
    
    context = {
        'data': data,
        'categories': categories,
        'brands': brands,
        'colors': colors,
        'sizes': sizes,
        'category': category if category_id else None,
        'basic': {
            'main': 'Project',
            'page': page_title,
        },
    }
    return render(request, 'main/category_product_list.html', context)

同时在urls.py中新增无参数路径：

# urls.py
urlpatterns=[
    path('', views.home, name='home'),
    path('category-list', views.category_list, name='category-list'),
    path('brand-list', views.brand_list, name='brand-list'),
    path('product-list', views.product_list, name='product-list'),
    path('category-product-list', views.category_product_list, name='category-product-list-all'),
    path('category-product-list/<int:category_id>', views.category_product_list, name='category-product-list'),
]

3. 修复HTML模板的URL反向解析 #

模板中生成商品分类链接时，传递当前商品的分类ID，修正语法错误：

<!-- category_product_list.html -->
{% extends 'base.html' %}
{% load static %}
{% block title %}{{basic.page}}{% endblock %}
{% block content %}
<main class="container my-4 n2-fnt">
    <!-- Featured Products -->
    <h3 class="my-4 pb-1 mb-5 n1-anim-tit">{{basic.page}}</h3>
    <div class="row">
        {% if data %}
            {% for i in data %}
            <div class="col-md-3 mb-4">
                <div class="card shadow">
                <a href="{% url 'category-product-list' i.category.id %}">
                    <img src="{{i.image.url}}" class="card-img-top" alt="{{i.title}}" />
                </a>
                <div class="card-body">
                    <h6 class="card-text n3-fnt">
                        <a href="{% url 'category-product-list' i.category.id %}">{{i.title}}</a>
                    </h6>
                </div>
                </div>
            </div>
            {% endfor %}
        {% endif %}
    </div>
</main>
{% endblock %}

4. 补充视图上下文（可选） #

如果需要在模板中显示当前分类信息，在视图的context中添加category对象（当category_id存在时），如步骤2中的代码所示。

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