Django REST Framework中外键关联用户信息无法按需嵌套显示

问题拆解 #

你碰到的核心问题点：

• Profile与User为一对一关联，Post通过外键关联Profile
• 使用StringRelatedField触发AttributeError：大概率是字段名不匹配（比如把单数profile写成复数profiles），或者该字段仅支持将关联对象转为字符串（不符合嵌套JSON需求）
• depth=1虽能实现嵌套返回，但会带出Profile的所有字段，无法满足只返回特定属性的要求

最优解决方案：自定义Profile序列化器 #

给Profile单独写一个仅包含所需字段的序列化器，再在Post的序列化器中引用它，精准控制返回内容。

1. 参考模型结构

from django.contrib.auth.models import User
from django.db import models

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    bio = models.TextField(blank=True)
    avatar = models.URLField(blank=True)
    location = models.CharField(max_length=100, blank=True)

class Post(models.Model):
    profile = models.ForeignKey(Profile, on_delete=models.CASCADE)
    title = models.CharField(max_length=200)
    content = models.TextField()

2. 编写精简版Profile序列化器

只保留你需要返回的字段，比如bio和avatar：

from rest_framework import serializers
from .models import Profile, Post

class ProfileMiniSerializer(serializers.ModelSerializer):
    class Meta:
        model = Profile
        fields = ('bio', 'avatar')  # 替换为你实际需要的字段

3. 修改Post的序列化器

用自定义的序列化器替代原有的StringRelatedField或depth参数：

class ListPostSerializer(serializers.ModelSerializer):
    # 引用自定义序列化器，实现嵌套返回指定字段
    profile = ProfileMiniSerializer(read_only=True)

    class Meta:
        model = Post
        fields = ('id', 'title', 'content', 'profile')  # 包含关联的profile字段

为什么之前的方法失效？ #

• StringRelatedField：本质是将关联对象转为字符串（调用模型__str__方法），不支持嵌套JSON结构；如果字段名写错（比如模型里是profile，你写profiles），直接触发AttributeError
• depth=1：会自动递归序列化关联对象的所有字段，无法做字段筛选，不符合需求

额外注意 #

如果Post模型中关联Profile的字段是复数profiles（一对多场景），需要把序列化器中的字段改为profiles = ProfileMiniSerializer(read_only=True, many=True)，先确认模型字段名是否匹配，这是触发AttributeError的高频原因。

内容的提问来源于stack exchange，提问作者Juan Alejandro Carrillo Jaimes