Django分类节点页面访问触发Page Not Found 404错误排查

核心触发原因 #

你当前报错的请求URL为http://127.0.0.1:8000/Category//，和你配置的路由规则Category/<category_id>/做结构对比可以发现：Category/路径段后直接拼接了末尾斜杠，说明模板渲染时本应填充的分类ID值为空，最终生成的无效路径完全匹配不上需要传入非空分类ID的路由规则，因此触发404异常。

问题定位与修复方案 #

• 第一处错误：模板内的上下文变量取值失效
  你使用的MPTT递归树标签{% recursetree listing %}的循环上下文里，不存在名为category_id的独立变量；每个分类节点的对象本身会被注入为node变量，分类的ID需要从node对象上读取（即node.id/node.pk）。直接引用不存在的category_id变量时，模板会渲染为空字符串，最终拼出带双斜杠的无效路径。
  错误的写法示例：

  <a href="Category/{{ category_id }}/">{{ node.name }}</a>
  

  先修正变量取值逻辑，把空值替换为当前循环节点的真实ID：

  <a href="Category/{{ node.id }}/">{{ node.name }}</a>
  

• 第二处优化：替换硬编码路径，规避静默错误
  手动拼接路径的方式，在变量取值为空时不会抛出明确报错，只会生成不规范的路径导致跳转404。可以用Django内置的{% url %}标签反向解析路由，完全对齐路由配置生成正确链接：

  <a href="{% url 'productlisting' node.id %}">{{ node.name }}</a>
  

  这种写法的优势是，如果传入的路由参数为空，Django会在模板渲染阶段直接抛出明确的参数错误，而不是静默生成无效路径，大幅降低排查成本；后续如果调整路由前缀，也不需要批量修改所有模板里的硬编码路径。
• 第三处校验：确认传入模板的树结构数据合法
  检查视图层传给模板的listing变量，是否是MPTT分类模型的合法树结构查询集，确保每个分类节点都有非空的主键ID，不要传入空列表、非树结构的普通数据进recursetree标签，避免即使写对变量名也取不到值的问题。

修复后校验步骤 #

1. 页面渲染完成后，右键检查生成的a标签href属性，确认路径为形如/Category/1/的规范结构，不存在双斜杠、空路径段
2. 点击分类名称，确认请求URL能正常匹配到productlisting视图，返回对应分类的商品列表页

内容的提问来源于stack exchange，提问作者Mustapha Mohd Sagagi