Django中如何获取Reception关联的完整Cart对象

问题背景 #

你定义了以下Django模型：

class Cart(models.Model):
    id = models.UUIDField(primary_key=True, default=uuid4)
    customer = models.ForeignKey(Customer, on_delete=models.CASCADE, null=True)


class Reception(models.Model):
    PAYMENT_STATUS_PENDING = 'P'
    PAYMENT_STATUS_COMPLETE = 'C'
    PAYMENT_STATUS_FAILED = 'F'
    PAYMENT_STATUS_CHOICES = [
        (PAYMENT_STATUS_PENDING, 'Pending'),
        (PAYMENT_STATUS_COMPLETE, 'Complete'),
        (PAYMENT_STATUS_FAILED, 'Failed')
    ]
    cart = models.ForeignKey(Cart, on_delete=models.CASCADE, null=True)
    customer = models.ForeignKey(Customer, on_delete=models.CASCADE)
    entry_date = models.DateField()
    total_price = models.IntegerField()
    payment_status = models.CharField(
        max_length=1,
        choices=PAYMENT_STATUS_CHOICES,
        default=PAYMENT_STATUS_PENDING
    )

当前使用的序列化器仅返回Cart的ID：

class ReceptionSerializer(serializers.ModelSerializer):
    class Meta:
        model = Reception
        fields = ['id', 'customer', 'entry_date', 'payment_status', 'cart']

解决方案 #

要返回完整的Cart对象，有两种常用实现方式：

方式1：嵌套序列化器（推荐，更灵活）

先定义Cart对应的序列化器，再在ReceptionSerializer中嵌套使用：

# 先定义Cart序列化器
class CartSerializer(serializers.ModelSerializer):
    class Meta:
        model = Cart
        fields = '__all__'  # 也可以指定具体字段，比如['id', 'customer']

# 修改Reception序列化器
class ReceptionSerializer(serializers.ModelSerializer):
    cart = CartSerializer()  # 嵌套Cart序列化器，返回完整对象

    class Meta:
        model = Reception
        fields = ['id', 'customer', 'entry_date', 'payment_status', 'cart']

方式2：使用depth参数（快捷，自动序列化关联对象）

在ReceptionSerializer的Meta类中添加depth属性，指定关联对象的序列化深度：

class ReceptionSerializer(serializers.ModelSerializer):
    class Meta:
        model = Reception
        fields = ['id', 'customer', 'entry_date', 'payment_status', 'cart']
        depth = 1  # 自动序列化一级关联对象（这里就是Cart）

两种方式对比 #

• 嵌套序列化器：可以自定义Cart返回的字段，还能添加额外的序列化逻辑，灵活性更高。
• depth参数：配置简单，会自动序列化关联对象的所有字段，但无法自定义返回字段。

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