DRF序列化器：外键写入传整数ID、读取返回关联嵌套对象

针对嵌套外键读时返回完整对象、写时接收ID的需求，以下是两种可复用、高性能的标准实现，完全不需要在视图层写循环替换逻辑。

方案1：重写序列化器输出方法（推荐，侵入性最低） #

核心思路是保留外键字段默认的写入逻辑（接收整数ID），仅在序列化输出（读场景）时替换为嵌套用户数据，配合ORM预加载彻底解决性能问题。

1. 修改UserAccessLogsSerializer：

   class UserAccessLogsSerializer(serializers.ModelSerializer):
       class Meta:
           model = UserAccessLogs
           fields = '__all__'
   
       def to_representation(self, instance):
           data = super().to_representation(instance)
           # 输出时替换user字段为完整用户信息
           data['user'] = UserSerializer(instance.user).data
           return data
   

2. 视图层查询时增加关联预加载，避免N+1查询：

   # select_related会通过JOIN一次性查出关联的用户数据，不会产生额外单条查询
   access_logs = UserAccessLogs.objects.all().select_related('user')
   serializer = UserAccessLogsSerializer(access_logs, many=True)
   return Response(serializer.data, status=status.HTTP_200_OK)
   

   该方案完全兼容原有写入逻辑，创建/更新日志时正常传user参数为用户ID即可，不会触发User模型的额外校验，逻辑全部封装在序列化器内可全局复用。

方案2：显式分离读写字段 #

如果需要更明确的字段定义，可以分别声明只读嵌套字段和只写外键字段，通过source参数绑定到同一个模型字段：

class UserAccessLogsSerializer(serializers.ModelSerializer):
    # 读场景：返回嵌套用户对象，只读不参与写入
    user = UserSerializer(read_only=True)
    # 写场景：接收用户ID，只写不参与输出，写入时映射到user外键
    user_id = serializers.PrimaryKeyRelatedField(
        queryset=Users.objects.all(),
        write_only=True,
        source='user'
    )

    class Meta:
        model = UserAccessLogs
        fields = '__all__'

使用该方案时，创建/更新日志的入参需要传user_id为用户ID，返回结果里user字段为完整嵌套对象，没有冗余字段。视图层同样需要加select_related('user')优化查询性能。

之前尝试的问题说明 #

• 直接声明user = UserSerializer()：DRF默认嵌套序列化器为可写，会将入参的user识别为完整用户对象，触发User模型的全量校验、甚至尝试更新/创建用户，和仅关联已有用户的需求冲突。
• 给嵌套字段加read_only=True后写入为null：只读字段不会参与反序列化流程，写入时框架无法获取到user的关联值，所以存储为null。
• 视图层循环调用User.objects.get()：属于典型的N+1查询问题，数据量越大性能损耗越严重，且逻辑散落在视图层无法复用。

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