Django DRF报instructor_id非空约束违规 不可修改字段时如何解决

报错根因 #

你当前的报错核心原因是CalendarSerializer中设置了depth = 1，DRF的depth配置会自动将所有关联外键字段设置为只读属性，你请求中携带的instructor/instructor_id参数不会被写入validated_data，最终创建数据时instructor_id为空触发数据库非空约束。
另外你当前的序列化器没有对必填的instructor字段做校验，导致错误没有在is_valid()阶段被提前拦截，直接到数据库操作阶段才抛出异常。

可行解决方案（无需修改模型字段定义） #

方案1：调整序列化器配置，恢复instructor字段可写权限

删除depth = 1配置，或者显式声明instructor字段为可写：

class CalendarSerializer(serializers.ModelSerializer):
    # 显式指定外键字段为可写，接收讲师主键ID
    instructor = serializers.PrimaryKeyRelatedField(queryset=Instructor.objects.all(), required=True)
    class Meta:
        model = Calendar
        fields = '__all__'
        depth = 1 # 如需保留嵌套返回讲师详情可保留该行，否则可以直接删除

该方案最符合DRF规范，required=True配置会在is_valid()阶段就校验instructor参数是否存在，提前返回参数缺失的错误，不会走到数据库报错环节。

方案2：视图层手动传入instructor参数

如果不想修改序列化器配置，可在调用save()方法时手动传入额外参数，优先级高于序列化器生成的validated_data：

# Calendar视图POST逻辑修改
if serializer.is_valid():
    # 手动从请求中取instructor_id传入save方法
    instructor_id = request.data.get('instructor')
    if not instructor_id:
        return Response({'message': 'instructor参数必填'}, status=status.HTTP_400_BAD_REQUEST)
    try:
        instructor = Instructor.objects.get(id=instructor_id)
    except Instructor.DoesNotExist:
        return Response({'message': '指定讲师不存在'}, status=status.HTTP_400_BAD_REQUEST)
    calendar_object = serializer.save(instructor=instructor)
    # 其余逻辑不变

方案3：配置默认讲师兜底

如果业务场景允许无明确讲师的日程，可以先在数据库中创建一个标记为「默认/未知讲师」的Instructor实例，然后在序列化器中配置字段默认值：

class CalendarSerializer(serializers.ModelSerializer):
    instructor = serializers.PrimaryKeyRelatedField(
        queryset=Instructor.objects.all(), 
        default=lambda: Instructor.objects.get(name="未知讲师") # 替换为你实际的默认讲师查询条件
    )
    class Meta:
        model = Calendar
        fields = '__all__'
        depth = 1

该方案下如果请求未传instructor参数，会自动用默认讲师填充，不会触发非空约束。

内容的提问来源于stack exchange，提问作者raj-kapil