Django设置根URL指向projects应用为首页时其他路由失效如何解决

Django路由按urlpatterns列表从上到下的顺序匹配，一旦匹配到符合规则的路径就立刻终止向后查找。你之前修改配置时，将空路径挂载projects应用的代码放在了blog/路由之前，projects中<slug:slug>/的泛匹配规则会把blog字符串作为slug参数捕获，直接路由到项目详情视图，请求根本不会走到后续的blog路由配置，因此blog相关路径全部失效。

根路由（主站点urls.py）调整 #

核心原则：所有带固定前缀的路由全部放在最前面优先匹配，最后再放根路径挂载的projects路由，避免projects的泛匹配规则拦截其他应用的请求。
最终配置代码：

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    # 固定前缀路由优先匹配
    path('admin/', admin.site.urls),
    path("blog/", include("blog.urls")),
    # 根路径关联projects路由，放在所有固定前缀路由之后
    path("", include("projects.urls")),
]

子路由说明 #

你现有blog、projects应用的子路由配置不需要做任何修改，调整根路由顺序后路径映射关系如下：

• 访问/：匹配projects应用的project_index视图，即你需要的站点首页
• 访问/blog/：优先匹配到blog/前缀，进入blog应用路由，匹配blog_index视图
• 访问/blog/<slug:slug>/：进入blog应用，匹配博客详情视图
• 访问/blog/<category>/：进入blog应用，匹配博客分类视图
• 访问/<slug:slug>/：进入projects应用，匹配项目详情视图
• 访问/project/<tag>/：进入projects应用，匹配项目标签筛选视图

如果后续需要新增多个根级固定路径的页面（比如关于页、用户中心页），担心projects的<slug:slug>/泛匹配规则误拦截，可以不用把整个projects应用挂载到根路径，只需要单独把根路径指向项目首页即可，保留projects原有前缀，配置如下：

# 根路由备选配置
from projects import views as project_views

urlpatterns = [
    path('admin/', admin.site.urls),
    # 单独指定根路径到项目首页
    path("", project_views.project_index, name="project_index"),
    path("projects/", include("projects.urls")),
    path("blog/", include("blog.urls")),
]

这种方案下项目详情页路径为/projects/<slug>/，不会和任何其他应用路由冲突，后续新增路由不需要考虑顺序问题，维护成本更低。

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