如何通过Django DRF序列化器手动设置AutoField主键ID值

Django原生支持手动指定AutoField自增主键的值，你现在遇到的ID不一致问题，是DRF序列化器的默认配置导致的。

DRF的ModelSerializer默认会把所有模型里的AutoField类型字段（也就是默认的id主键）设为只读字段，即使你传入的参数里带了id值，反序列化校验环节会直接忽略该字段，最终保存实例时会走数据库自增逻辑生成新ID，自然和外部API返回的ID对不上。

只需要在序列化器里显式声明id字段，放开写入权限即可，Django ORM保存实例时，只要手动传入的主键值不重复，就会直接使用该值作为主键，不会触发自增逻辑：

from rest_framework import serializers
from .models import Car


class CarSerializer(serializers.ModelSerializer):
    # 显式声明id字段，允许写入，非必填
    id = serializers.IntegerField(required=False)
    class Meta:
        model = Car
        fields = ['id', 'speed', 'color', 'wheels']

改完之后你现有逻辑里传入带id的外部API数据，序列化器就会正常读取id值，保存后本地记录ID和外部数据ID完全一致。

基础方案能解决ID不一致问题，但还有几个可优化的点，避免线上出问题：

• 不要在GET请求中做跨API拉取、数据库写入操作。GET请求按REST规范应该是无副作用的幂等请求，把拉取外部数据落库的逻辑抽成独立工具方法，或者放到异步任务里，避免正常查询请求因为外部API超时拖慢响应。
• 增加主键冲突兜底逻辑。并发场景下可能出现多个请求同时拉到同一个ID的车辆数据，保存时触发主键冲突异常，需要做捕获处理：

from django.db import IntegrityError

@api_view(['GET', 'PUT', 'DELETE'])
def car_detail_id(request, id):
    try:
        car = Car.objects.get(pk=id)
    except Car.DoesNotExist:
        car_data = search_car(id) # 从外部API拉取车辆数据
        if request.method == "GET" and car_data is not None:
            target_id = car_data['id']
            # 二次校验目标ID是否已存在，减少冲突概率
            existing_car = Car.objects.filter(pk=target_id).first()
            if existing_car:
                return Response(CarSerializer(existing_car).data, status=status.HTTP_200_OK)
            
            serializer = CarSerializer(data=car_data)
            if serializer.is_valid():
                try:
                    serializer.save()
                    return Response(serializer.data, status=status.HTTP_201_CREATED)
                except IntegrityError:
                    # 并发冲突兜底，直接返回已创建的记录
                    existing_car = Car.objects.get(pk=target_id)
                    return Response(CarSerializer(existing_car).data, status=status.HTTP_200_OK)
            return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
        return Response(status=status.HTTP_404_NOT_FOUND)
    return car_detail(request, "id", car)

• 限制主键写入权限，避免恶意篡改。如果这个序列化器同时给前端普通增删改查接口用，建议不要全局放开id的写入权限，通过上下文控制写入权限，只在内部拉取外部数据落库的场景允许自定义ID：

class CarSerializer(serializers.ModelSerializer):
    class Meta:
        model = Car
        fields = ['id', 'speed', 'color', 'wheels']
    
    def get_fields(self):
        fields = super().get_fields()
        # 只有上下文传入allow_custom_id标记时，才放开id写入
        if not self.context.get('allow_custom_id', False):
            fields['id'].read_only = True
        return fields

内部落库调用时传入对应上下文即可，普通前端请求不会触发权限放开：

serializer = CarSerializer(data=car_data, context={'allow_custom_id': True})

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