Django访问URL返回404，多slug层级路由配置冲突如何解决

问题根源 #

本次404问题的核心根源是同段数的路由格式完全冲突，Django的路由匹配遵循从上到下、命中即停止的规则：
当前配置中两段路径的两个路由格式完全一致：

• 区域页路由：path('<str:parent>/<str:region>/', vineyard_region, name="region") 匹配任意2段字符串格式的路径
• 无父级的酒庄详情路由：path('<str:region>/<slug:slug>/', vineyard_detail, name="detail-without-parent") 同样匹配任意2段字符串格式的路径
  无论如何调整这两个路由的顺序，排在前面的路由会吃掉所有符合2段字符串格式的请求，排在后面的永远不会被匹配到，仅靠调整顺序无法解决该冲突。
  三段路径的酒庄详情路由detail无法访问，通常是调整顺序时误将短段数路由放在长段数路由前面导致，解决两段路由冲突后，现有排序中form路由在前、参数路由在后的规则可以保证三段路由正常工作。
  slug/slug格式的路由完全可以正常支持，不需要拆分到多个urls文件，只要解决路由区分问题即可。

解决方案 #

方案一：添加固定前缀区分（最推荐） #

给不同业务类型的路由加固定前缀，从URL结构上直接区分区域页和酒庄页，完全避免冲突，同时URL语义更清晰：

app_name = 'vineyards'
urlpatterns = [
    # 表单路由保持原有逻辑
    path('<slug:parent>/<slug:region>/<slug:slug>/form/',
         rr_form, name="detail-form"),
    path('<slug:region>/<slug:slug>/form/',
         rr_form, name="detail-without-parent-form"),
    # 区域页统一添加 region/ 前缀
    path('region/<slug:parent>/<slug:region>/', vineyard_region, name="region"),
    path('region/<slug:region>/', vineyard_region, name="region-without-parent"),
    # 酒庄详情页统一添加 vineyard/ 前缀
    path('vineyard/<slug:parent>/<slug:region>/<slug:slug>/',
         vineyard_detail, name="detail"),
    path('vineyard/<slug:region>/<slug:slug>/',
         vineyard_detail, name="detail-without-parent"),
]

优化说明：将原有str类型参数替换为slug类型，和模型中SlugField字段属性对应，Django会自动校验参数格式，避免无效请求进入视图逻辑。
修改路由后需要同步调整模型中get_absolute_url方法的反向生成逻辑，加上对应的前缀即可。

方案二：统一视图处理（仅适用于不能修改URL结构的场景） #

如果必须保留原有的URL结构，可以删除其中一个两段路由，统一用一个视图处理所有两段路径的请求，在视图内做业务判断：

1. 先根据第一段参数查询对应Region，再判断第二段参数是否是该Region的子Region的slug：是则执行区域页逻辑
2. 如果不匹配，再判断第二段参数是否是属于该Region的Vineyard的slug：是则执行酒庄详情逻辑
3. 都不匹配则返回404
   该方案存在slug重名冲突风险，且会额外增加数据库查询开销，非必要不建议使用。

路由配置通用规则 #

日常配置路由时遵循两个原则可避免大部分匹配冲突：

• 路径段数多的路由放在前面，段数少的放在后面
• 包含固定字符串的路由放在前面，全参数的路由放在后面

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