Django REST Framework：关联模型序列化无法引用关联字段，报字段无效错

你遇到的问题是因为name、image属于关联的Recipe模型，而非FavoriteRecipe本身，直接在序列化器中指定这些字段自然会报错。以下是两种可靠的实现方式：

方式1：嵌套序列化器（推荐，结构清晰） #

先为Recipe创建一个用于嵌套的序列化器，再在FavoriteRecipe的读序列化器中引用它：

模型示例（确认结构） #

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

class Recipe(models.Model):
    name = models.CharField(max_length=255)
    image = models.URLField()
    # 其他业务字段

class FavoriteRecipe(models.Model):
    user = models.ForeignKey(User, on_delete=models.CASCADE)
    recipe = models.ForeignKey(Recipe, on_delete=models.CASCADE)
    created_at = models.DateTimeField(auto_now_add=True)

序列化器代码 #

from rest_framework import serializers
from .models import Recipe, FavoriteRecipe

# 用于嵌套的Recipe序列化器，只返回需要的字段
class RecipeNestedSerializer(serializers.ModelSerializer):
    class Meta:
        model = Recipe
        fields = ('name', 'image')

# 收藏记录的读序列化器
class FavoriteRecipeSerializerForRead(serializers.ModelSerializer):
    # 嵌套关联的Recipe序列化器
    recipe = RecipeNestedSerializer()

    class Meta:
        model = FavoriteRecipe
        fields = ('id', 'created_at', 'recipe')

视图层优化查询（避免N+1问题） #

在查询收藏记录时，用select_related预加载关联的Recipe数据：

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import FavoriteRecipe

class UserFavoritesView(APIView):
    def get(self, request):
        # 预加载关联的Recipe，减少数据库查询次数
        favorite_records = FavoriteRecipe.objects.filter(user=request.user).select_related('recipe')
        serializer = FavoriteRecipeSerializerForRead(favorite_records, many=True)
        return Response(serializer.data)

方式2：平级返回关联字段（适合需要扁平化结构的场景） #

如果不想用嵌套结构，而是把Recipe的字段和FavoriteRecipe的字段放在同一层级，可以用source参数指定关联路径：

序列化器代码 #

class FavoriteRecipeSerializerForRead(serializers.ModelSerializer):
    # 通过source指定关联模型的字段
    recipe_name = serializers.CharField(source='recipe.name')
    recipe_image = serializers.URLField(source='recipe.image')

    class Meta:
        model = FavoriteRecipe
        fields = ('id', 'created_at', 'recipe_name', 'recipe_image')

视图层同样需要用select_related优化查询，代码和方式1一致。 #

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