Django路径与URL不匹配：为何定义的路由无法匹配指定请求URL？

核心原因有两点： #

• 路由路径开头的斜杠导致拼接错误
  从Django输出的尝试匹配列表能看到，你的search路由被解析成了akdbapp/ /search/<str:q>——这是因为子路由里写了path('/search/<str:q>', views.search, name="search")，开头的/和主URLconf中akdbapp/的前缀拼接后，出现了连续双斜杠//，但实际请求的路径是akdbapp/search/，两者结构不符，自然无法匹配。Django子路由的路径开头不需要加/，正确写法应为path('search/<str:q>', views.search, name="search")。

• 参数传递方式不匹配
  你定义的路由使用的是URL路径参数<str:q>，要求参数直接嵌入URL路径（比如http://127.0.0.1:8000/akdbapp/search/foo）；但实际请求用的是查询参数?q=foo，这种参数不属于URL路径的一部分，Django的URL匹配逻辑不会将其纳入匹配范围，此时请求的实际路径是akdbapp/search/，和带有<str:q>参数的路由完全不匹配。

两种修正方案： #

1. 适配查询参数的写法：修改路由为path('search/', views.search, name="search")，在视图函数中通过request.GET.get('q')获取查询参数；
2. 适配路径参数的写法：修正路由开头的斜杠，同时将请求URL改为http://127.0.0.1:8000/akdbapp/search/foo形式。

内容的提问来源于stack exchange，提问作者Harry S