为何Django REST Framework为两个同QuerySet视图生成相同API URL？

这是一个基于Django REST Framework的联系表单项目，需求为：

• 前端普通用户仅能通过POST请求提交联系消息
• 管理员仅能通过GET请求查看所有联系列表

项目核心配置如下：

Models.py #

class Contact(models.Model):
    full_name = models.CharField(max_length=100)
    email = models.EmailField()
    phone_no = models.CharField(max_length=10, validators=[validate_phone_no])
    message = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True, blank=True, null=True)
    
    def __str__(self):
        return self.email

serializers.py #

class ContactSerializer(serializers.ModelSerializer):
    class Meta: 
        model = Contact
        fields = [
            'full_name',
            'email',
            'phone_no',
            'message',
        ]

Views.py #

class ContactViewset(viewsets.ModelViewSet):
    permission_classes = [IsAuthenticated]
    queryset = Contact.objects.all()
    search_fields = []
    ordering_fields = []
    ordering = []
    http_method_names = ["options", "head", "get"]

    serializer_class = ContactSerializer


class CustomerContactViewSet(viewsets.ModelViewSet):
    permission_classes = [AllowAny]
    queryset = Contact.objects.all()
    http_method_names = ['post']

    serializer_class = ContactSerializer

urls.py #

router.register("contacts-detail", ContactViewset)
router.register("contact-form", CustomerContactViewSet)

问题现象 #

明明给两个视图集注册了不同的路由前缀（contacts-detail和contact-form），但DRF最终生成的API URL却全部指向contact-form。已知通过显式设置base_name可以解决这个问题，下面解析背后的路由生成机制：

核心机制解析 #

DRF的DefaultRouter（或SimpleRouter）在注册视图集时，会依赖**base_name**来区分不同的路由组，它的生成逻辑是：

1. 如果注册时显式指定了base_name，则直接使用该值
2. 如果没有指定，会自动从视图集的queryset中推断：提取queryset.model._meta.model_name作为base_name（这里就是contact，因为模型是Contact）

在上述代码中，两个视图集的queryset都是Contact.objects.all()，所以DRF自动推断出的base_name都是contact。而路由器内部是用base_name作为唯一标识来管理路由组的——当注册第二个视图集时，因为base_name和第一个重复，路由器会认为是在更新同一个路由组的配置，最终后注册的路由前缀（contact-form）会覆盖掉之前的前缀（contacts-detail），导致所有对应这个base_name的路由都指向了最后注册的URL。

解决方法 #

给两个视图集分别指定不同的base_name，让路由器识别为独立的路由组：

router.register("contacts-detail", ContactViewset, base_name="admin-contact")
router.register("contact-form", CustomerContactViewSet, base_name="customer-contact")

这样路由器就会为两个视图集分别生成对应的路由，不会再出现覆盖的情况。

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