Django Rest Framework路由未找到：ModelViewSet与SimpleRouter配置问题

你遇到的路由未找到错误，核心原因是TeamViewSet的详情路由正则会优先匹配/teams/players/路径，把players误当作Team的pk参数，导致PlayersViewSet的路由根本没机会被触发。

为什么会出现这个问题？ #

SimpleRouter给ModelViewSet生成的详情路由规则是^(?P<pk>[^/.]+)/$，这个正则会匹配任何不含斜杠的字符串。当你访问/teams/players/时，Django会把players解析成Team的pk值，去调用TeamViewSet的retrieve方法查找对应Team——显然不存在这个pk的Team，所以返回404。

两种快速解决方法 #

方法一：调整路由注册顺序（适配你当前的结构）

路由匹配是按注册顺序执行的，只要先注册PlayersViewSet，让它的路由规则优先被匹配，就能避开冲突。修改team.urls：

from rest_framework.routers import SimpleRouter
from . import views

router = SimpleRouter()
# 先注册players，确保它的路由先被匹配
router.register('players', views.PlayersViewSet, base_name='players')
# 再注册teams的空路径
router.register('', views.TeamViewSet, base_name='teams')

urlpatterns = [
    url(r'^', include(router.urls))
]

这样访问/teams/players/时会优先匹配PlayersViewSet的列表路由，而/teams/123/这类路径才会触发TeamViewSet的详情逻辑。

方法二：重构路由结构（更清晰，避免潜在冲突）

如果不想依赖注册顺序，也可以直接在主路由里定义完整的路由规则，逻辑更直观：

修改main.urls：

from rest_framework.routers import SimpleRouter
from team import views

router = SimpleRouter()
router.register(r'teams', views.TeamViewSet, base_name='teams')
router.register(r'teams/players', views.PlayersViewSet, base_name='players')

urlpatterns = [
    url(r'^', include(router.urls)),
]

这种方式不需要再依赖team.urls的嵌套，路由规则一目了然，彻底避免正则匹配冲突。

额外注意事项 #

确保你的两个ViewSet都正确继承了ModelViewSet，并且要么定义了queryset属性，要么实现了get_queryset方法——这是DRF视图集正常工作的基础。

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