DRF如何创建序列化器通过external_id校验外键关联创建Book实例

现有代码运行失败的核心问题是序列化器默认的student字段类型为PrimaryKeyRelatedField，该字段默认会校验传入值是否为Student模型的主键值，你传入的external_id不是主键，在序列化器的参数校验阶段就会抛出无效错误，不会进入你自定义的create方法执行。

自定义接收external_id的字段，提前在校验阶段判断学生是否存在，修改后的序列化器代码如下：

from rest_framework import serializers
from rest_framework.exceptions import ValidationError
from .models import Student, Book

class BooksSerializer(serializers.ModelSerializer):
    # 新增写字段接收前端传入的学生external_id
    student_external_id = serializers.CharField(max_length=30, write_only=True)
    # 原有student字段设为只读，返回时自动序列化关联学生信息
    student = serializers.PrimaryKeyRelatedField(read_only=True)

    class Meta:
        model = Book
        fields = [
            "student",
            "student_external_id",
            "book_name",
            "book_type",
        ]

    # 校验学生是否存在，以及一对一关联是否重复
    def validate_student_external_id(self, value):
        try:
            student = Student.objects.get(external_id=value)
        except Student.DoesNotExist:
            raise ValidationError("对应学生不存在")
        # 因Book和Student为一对一关联，额外校验是否已存在关联记录
        if Book.objects.filter(student=student).exists():
            raise ValidationError("该学生已绑定书籍，不可重复创建")
        return value

    def create(self, validated_data):
        student_external_id = validated_data.pop('student_external_id')
        st = Student.objects.get(external_id=student_external_id)
        book = Book.objects.create(student=st, **validated_data)
        return book

前端调用创建接口时，只需传入student_external_id、book_name、book_type三个参数即可，学生不存在时会在校验阶段直接抛出对应错误。

不需要强制放弃单独的Book创建接口，两种方案可以根据业务场景选择：

• 如果创建书籍是独立的业务操作，和学生其他操作没有强绑定，单独的Book创建接口完全符合RESTful规范，可正常使用
• 如果业务逻辑中创建书籍本身就是学生资源的附属操作，建议使用/students/{external_id}/books/路径的POST接口实现，直接从URL中获取external_id，不需要在请求体中传递关联字段，代码会更简洁

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