Django REST Framework：如何在PrimaryKeyRelatedField嵌套序列化器中获取关联字段名称

首先先纠正个小细节：你说的应该是DRF里的PrimaryKeyRelatedField（不是PrimaryKeyRelatedSerializer），先明确这个，咱们往下说。

如何同时返回关联主键和街区名称 #

要保留主键字段的同时额外获取街区名称，最直接的方式是用SerializerMethodField在序列化器里加一个自定义字段，具体实现如下：

假设你的模型结构大概是这样：

from django.db import models

class Block(models.Model):
    name = models.CharField(max_length=100, verbose_name="街区名称")
    # 其他街区相关字段

class TargetModel(models.Model):
    block = models.ForeignKey(Block, on_delete=models.CASCADE, verbose_name="关联街区")
    # 你的模型其他字段

对应的序列化器可以这么写：

from rest_framework import serializers
from .models import TargetModel, Block

class TargetModelSerializer(serializers.ModelSerializer):
    # 保留主键关联字段，满足你需要主键的需求
    block = serializers.PrimaryKeyRelatedField(queryset=Block.objects.all())
    # 新增自定义字段，返回街区名称
    block_name = serializers.SerializerMethodField()

    def get_block_name(self, obj):
        # 从关联的Block对象中取出name字段
        return obj.block.name

    class Meta:
        model = TargetModel
        # 把需要的字段都列出来，包括block和block_name
        fields = ["id", "block", "block_name", ...]  # 替换...为你的其他字段

这样调用API时，返回的响应里就会同时包含block（主键值）和block_name（街区名称），完全满足你的需求。

如果你想把主键和名称合并到同一个字段里（返回一个包含id和name的字典），也可以自定义一个继承自PrimaryKeyRelatedField的字段，重写to_representation方法：

class BlockWithNamePrimaryKeyField(serializers.PrimaryKeyRelatedField):
    def to_representation(self, value):
        return {
            "id": value.pk,
            "name": value.name
        }

class TargetModelSerializer(serializers.ModelSerializer):
    block = BlockWithNamePrimaryKeyField(queryset=Block.objects.all())

    class Meta:
        model = TargetModel
        fields = ["id", "block", ...]

不过这种方式返回的block是个字典，如果你需要单独的主键字段，还是第一种方法更贴合你的需求。

关于PrimaryKeyRelatedField的意义 #

这个字段的核心价值在于轻量的序列化与反序列化，专注于关联关系的主键传递，主要适用场景包括：

• 减少响应数据量：当你不需要关联对象的全部信息，只需要主键用来做后续操作（比如前端拿着主键请求街区详情），用它可以避免返回冗余数据，提升API响应速度。
• 简化前端交互：前端只需要传递主键就能完成关联对象的绑定，不需要构造复杂的嵌套序列化数据，降低前端开发成本。
• 高效的反序列化处理：在创建或更新对象时，DRF会自动通过主键找到对应的关联对象并完成绑定，不需要手动处理对象查找逻辑，代码更简洁。

举个例子：当你用POST请求创建TargetModel实例时，前端只需要传{"block": 1, ...}（1是Block的主键），DRF会自动找到id为1的Block对象并关联，这比用嵌套序列化器需要传整个Block的字段数据要高效得多。

简单来说，它就是为了在不需要关联对象完整信息的场景下，提供一种轻量、高效的关联处理方式，这也是它存在的意义。

内容的提问来源于stack exchange，提问作者amazing carrot soup