DRF中注册的API路由为何合并？请求原因分析与解决指导

问题原因 #

DRF的DefaultRouter在注册ViewSet时，会根据ViewSet关联的模型自动生成basename（路由的基础名称）。如果两个ViewSet都基于同一个User模型，它们的默认basename都是user，路由器会将这两个ViewSet的路由视为同一资源的不同扩展，最终导致路由合并，无法生成两个独立的路由分支。

解决方案 #

方案1：手动定义URL路径（推荐独立路由场景） #

放弃使用DefaultRouter自动注册，手动为两个ViewSet编写URL规则，明确指定每个路由对应的ViewSet动作：

# urls.py
from django.urls import path
from .views import UserViewSet, UserActivityViewSet

urlpatterns = [
    # 用户完整数据路由
    path('users/', UserViewSet.as_view({'get': 'list', 'post': 'create'}), name='user-list'),
    path('users/<int:pk>/', UserViewSet.as_view({'get': 'retrieve', 'put': 'update', 'patch': 'partial_update', 'delete': 'destroy'}), name='user-detail'),
    
    # 用户活动数据独立路由
    path('user-activity/', UserActivityViewSet.as_view({'get': 'list'}), name='user-activity-list'),
    path('user-activity/<int:pk>/', UserActivityViewSet.as_view({'get': 'retrieve'}), name='user-activity-detail'),
]

这种方式让两个路由完全独立，还能根据需求灵活控制每个路由支持的HTTP方法。

方案2：注册ViewSet时指定不同的basename #

如果仍想使用DefaultRouter自动生成路由，需要为两个ViewSet指定唯一的basename，让路由器识别为两个独立资源：

# urls.py
from rest_framework import routers
from .views import UserViewSet, UserActivityViewSet

router = routers.DefaultRouter()
router.register(r'users', UserViewSet, basename='user')
router.register(r'user-activity', UserActivityViewSet, basename='user-activity')

urlpatterns = [
    path('', include(router.urls)),
]

basename是路由名称的前缀，必须唯一。此时路由器会生成/users/和/user-activity/两个独立的路由分支。

方案3：将用户活动作为users路由下的自定义动作（适合关联场景） #

如果用户活动接口属于用户资源的附属接口，可以用DRF的@action装饰器在UserViewSet中添加自定义动作，无需单独注册ViewSet：

# views.py
from rest_framework import viewsets, Response
from .models import User
from .serializers import UserSerializer, UserActivitySerializer

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer

    @action(detail=False, methods=['get'])
    def activity(self, request):
        queryset = User.objects.all()
        serializer = UserActivitySerializer(queryset, many=True)
        return Response(serializer.data)
    
    @action(detail=True, methods=['get'])
    def activity_detail(self, request, pk=None):
        user = self.get_object()
        serializer = UserActivitySerializer(user)
        return Response(serializer.data)

此时会自动生成/users/activity/（列表）和/users/<pk>/activity_detail/（详情）路由，无需额外注册ViewSet。

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