Django DRF主键同时为外键模型使用HyperlinkedModelSerializer问题求解

问题根因 #

Django ORM 中，你在Profile模型定义的关联字段为member，member_id是ORM自动生成的数据库字段映射属性，仅存储Member主键的整数值，并非关联的Member对象实例。你直接对member_id属性绑定嵌套序列化器或关联字段时：

• 嵌套序列化器需要接收模型实例才能序列化字段，传入整数自然返回空对象
• HyperlinkedRelatedField需要从实例中读取id属性，传入整数自然抛出'int' object has no attribute 'id'错误

解决方案 #

方案1：保留输出字段名为member_id，嵌套返回Member完整信息 #

通过source参数指定数据源为关联的member对象即可，无需修改原有输出字段命名：

class MemberProfileSerializer(serializers.HyperlinkedModelSerializer):
    member_id = MemberSerializer(source='member', read_only=True)
    class Meta:
       model = Profile
       fields = ['member_id','bio','address','mobile']

方案2：保留输出字段名为member_id，返回Member详情链接 #

同样通过source指定数据源为关联对象：

class MemberProfileSerializer(serializers.HyperlinkedModelSerializer):
    member_id = serializers.HyperlinkedRelatedField(
        view_name = 'member-detail',
        lookup_field='id',
        source='member',
        read_only=True
    )
    class Meta:
       model = Profile
       fields = ['member_id','bio','address','mobile']

方案3：适配DRF默认命名规范（可选） #

如果不需要严格保留member_id的输出字段名，直接使用关联字段名member定义序列化规则，更符合框架默认设计：

class MemberProfileSerializer(serializers.HyperlinkedModelSerializer):
    member = MemberSerializer(read_only=True)
    class Meta:
       model = Profile
       fields = ['member','bio','address','mobile']

性能优化建议 #

查询Profile数据时，使用select_related预加载关联的Member对象，避免触发N+1查询问题：

# 视图中查询示例
profile_queryset = Profile.objects.select_related('member').all()

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