Django URL匹配失败的常见原因及解决方案-Python教程-PHP中文网

Django URL匹配失败的常见原因及解决方案

Django中URL未匹配到视图通常因路径定义缺少尾部斜杠，导致路由无法正确识别；需确保urlpatterns中所有path()参数的URL模式与请求路径严格一致（如'new/'而非'new'）。

django中url未匹配到视图通常因路径定义缺少尾部斜杠，导致路由无法正确识别；需确保`urlpatterns`中所有`path()`参数的url模式与请求路径严格一致（如`'new/'`而非`'new'`）。

在Django中，URL路由匹配是精确字符串匹配（不自动补全或忽略尾部斜杠），这与部分框架的“宽容匹配”不同。你遇到的 /products/new/ 404 错误，根本原因在于 urls.py 中定义的是 path('new', ...) —— 它只匹配 不带尾斜杠 的 /products/new，而浏览器实际请求的是 /products/new/（Django开发服务器默认重定向或用户手动输入常含末尾斜杠），二者不一致，自然匹配失败。

观察你提供的URLconf输出：

products/ new

说明Django将 'new' 解析为一个独立路径段，且未声明结尾斜杠，因此它无法响应 /products/new/（注意末尾的 /）。

✅ 正确做法：在 path() 的第一个参数中显式添加尾部斜杠，使其与典型HTTP请求习惯一致：

Django

避免常见的 Django 错误——QuerySet 评估、N+1 查询、迁移冲突和 ORM 陷阱。

下载

# products/urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='products-index'),
    path('salt/', views.trending, name='products-salt'),   # ✅ 添加 '/'
    path('new/', views.new, name='products-new'),          # ✅ 添加 '/'
]

同时，请确认主 urls.py（如 pyshop/urls.py）中包含 products/ 的 include() 调用已正确配置，并启用 APPEND_SLASH=True（Django默认开启）——该设置会尝试将不匹配的无斜杠请求（如 /products/new）重定向到带斜杠版本（/products/new/），但前提是你的路由本身支持带斜杠形式。因此，路由定义必须主动兼容带斜杠路径。

⚠️ 注意事项：

不要混用 'new' 和 'new/'：同一项目应统一风格（推荐全部使用 'xxx/'）；
若使用 re_path() 或正则路由，需自行处理斜杠逻辑，path() 更安全、更直观；
Django 2.1 已于2020年终止支持，存在安全风险；强烈建议升级至长期支持（LTS）版本（如 4.2+ 或 5.0+），以获得稳定路由行为、安全补丁及path()等现代API的完整特性支持。

总结：URL匹配失败不是“随机现象”，而是路径字面量不匹配的必然结果。修正方式简单而关键——为每个 path() 的route字符串显式添加尾部斜杠 /，并保持整个项目路由风格统一。