如何在Django REST Framework中通过主键生成Users表的超链接？

嗨，我明白你遇到的问题了——你想用DRF生成指向单个用户详情的超链接（比如127.0.0.1:8000/users/{userid}），但误用了HyperlinkedRelatedField，这个字段其实是用来处理关联其他模型的链接的，要生成当前资源自身的详情链接，你需要用HyperlinkedIdentityField。

下面一步步给你讲怎么实现：

1. 核心：用HyperlinkedIdentityField替代HyperlinkedRelatedField #

这个字段专门用来生成当前模型实例的详情页超链接，直接加到你的User序列化器里就行。

示例序列化器代码 #

# serializers.py
from rest_framework import serializers
from .models import User

class UserSerializer(serializers.ModelSerializer):
    # 生成用户详情的超链接
    url = serializers.HyperlinkedIdentityField(
        view_name='user-detail',  # 必须和你URL配置里的详情路由name一致
        lookup_field='pk'  # 对应URL里的{userid}，也就是主键，默认就是pk可以省略，但显式写更清晰
    )
    # 如果需要序列化关联的Location链接，这里才用HyperlinkedRelatedField
    location = serializers.HyperlinkedRelatedField(
        view_name='location-detail',
        read_only=True
    )

    class Meta:
        model = User
        fields = ['id', 'url', 'name', 'location']  # 把url字段加入返回的字段列表

2. 确保URL配置和序列化器匹配 #

你的URL路由需要给用户详情页设置一个name，这个name必须和上面view_name的值完全一致：

# urls.py
from django.urls import path
from .views import UserDetailView, UserListView

urlpatterns = [
    path('users/', UserListView.as_view(), name='user-list'),
    # 这里的name='user-detail'要和序列化器里的view_name对应
    path('users/<int:pk>/', UserDetailView.as_view(), name='user-detail'),
    # 对应的Location详情路由（如果需要的话）
    path('locations/<int:pk>/', LocationDetailView.as_view(), name='location-detail'),
]

3. 视图中必须传递request上下文 #

DRF需要通过request对象来生成完整的绝对URL（包含域名和端口），所以在序列化的时候一定要确保传递context={'request': request}：

如果你用自定义APIView： #

# views.py
from rest_framework.views import APIView
from rest_framework.response import Response
from .models import User
from .serializers import UserSerializer

class UserDetailView(APIView):
    def get(self, request, pk):
        user = User.objects.get(pk=pk)
        # 必须传context，把request传进去
        serializer = UserSerializer(user, context={'request': request})
        return Response(serializer.data)

class UserListView(APIView):
    def get(self, request):
        users = User.objects.all()
        # 列表序列化也要传context
        serializer = UserSerializer(users, many=True, context={'request': request})
        return Response(serializer.data)

如果你用ModelViewSet/GenericAPIView： #

这类视图会自动帮你处理上下文，不需要手动传，直接用就行：

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

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

关键注意事项 #

• view_name必须完全匹配：如果URL里的name是user-detail，序列化器里的view_name就不能写错，否则DRF会找不到路由报错。
• 不要忘传request上下文：如果没传context，生成的会是相对路径，而不是包含域名的完整URL。
• HyperlinkedRelatedField的正确用法：这个字段是用来展示关联模型的链接（比如用户关联的地点），而不是当前模型自身的链接，这就是你之前用它没成功的原因。

这样设置后，你获取用户数据的时候，就能看到类似"url": "http://127.0.0.1:8000/users/1/"的字段了，点击这个链接就能直接获取该用户的详情JSON。

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