DRF嵌套序列化器POST请求外键非空约束错误求助

问题根源 #

你碰到的django.db.utils.IntegrityError: NOT NULL constraint failed: api_order.exams_id，本质是提交Order数据时，exams这个外键字段没被正确赋值——要么序列化器没接收传入的ID，要么字段名不匹配，导致DRF没法把JSON里的检查项ID关联到Order实例上。之前设默认值后没法覆盖，说明你传的字段根本没被序列化器识别。

具体修复步骤 #

1. 确认Model外键配置 #

先检查Order模型的exams字段，确保是正确的一对一关系，且业务上确实需要非空（如果必须关联检查项，null=False没问题，但要保证提交时能传值）：

# models.py
from django.db import models
from .models import Exam  # 你的检查项模型

class Order(models.Model):
    # 一对一关联Exam，on_delete根据业务选CASCADE/PROTECT等
    exams = models.OneToOneField(Exam, on_delete=models.CASCADE, null=False)
    # 其他业务字段...

2. 修正序列化器 #

序列化器必须明确处理exams字段，让它能接收检查项ID：

# serializers.py
from rest_framework import serializers
from .models import Order, Exam

class OrderSerializer(serializers.ModelSerializer):
    # 用PrimaryKeyRelatedField指定可接收Exam的ID，queryset用于验证ID合法性
    exams = serializers.PrimaryKeyRelatedField(queryset=Exam.objects.all())
    
    class Meta:
        model = Order
        # fields里必须包含exams，不然序列化器会忽略这个字段
        fields = ['id', 'exams', '你的其他字段']

之前如果序列化器没把exams加入fields，或者用了只读字段（比如ReadOnlyField），那你传的exams ID根本不会被处理，保存时自然要么用默认值要么为空。

3. 检查POST的JSON格式 #

确保JSON里的字段名和序列化器里的完全一致，比如序列化器里是exams，就这么传：

{
    "exams": 1,  # 这里填真实存在的检查项ID
    "你的其他字段": "对应值"
}

别写成exams_id，DRF会自动处理外键ID的映射。

4. 视图层确保正确处理请求 #

如果用的是ModelViewSet或者CreateAPIView，别乱重写create方法导致数据丢失：

# views.py
from rest_framework import viewsets
from .models import Order
from .serializers import OrderSerializer

class OrderViewSet(viewsets.ModelViewSet):
    queryset = Order.objects.all()
    serializer_class = OrderSerializer

如果是自定义视图，要把request.data正确传给序列化器：

from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from .models import Order
from .serializers import OrderSerializer

class OrderCreateView(APIView):
    def post(self, request):
        serializer = OrderSerializer(data=request.data)
        # 直接抛出验证错误，方便排查问题
        if serializer.is_valid(raise_exception=True):
            serializer.save()
            return Response(serializer.data, status=status.HTTP_201_CREATED)

5. 删掉无效的默认值 #

之前给order.exams设的默认值会干扰传入的ID（如果序列化器没处理对的话），直接删掉默认值，强制通过传入ID关联检查项：

# 移除default参数，保持非空约束
exams = models.OneToOneField(Exam, on_delete=models.CASCADE, null=False)

验证方法 #

1. 先通过GET请求确认检查项的ID是有效的（比如访问/api/exams/看返回的ID）
2. 用正确的JSON格式POST到Order创建接口
3. 查数据库，确认Order的exams_id字段已经被正确赋值

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