Django Rest Framework提交UUID列表至PrimaryKeyRelatedField报错求助

1. 提交UUID列表的正确方式 #

先确认序列化器配置正确，示例代码如下：

from rest_framework import serializers
from .models import Post, User

class PostSerializer(serializers.ModelSerializer):
    mentioned_users = serializers.PrimaryKeyRelatedField(
        many=True,
        queryset=User.objects.all(),
        pk_field=serializers.UUIDField(format='hex_verbose')
    )

    class Meta:
        model = Post
        fields = ['content', 'mentioned_users']

提交请求时必须用JSON格式传递数组，请求体示例：

{
    "content": "这是一条@多位用户的帖子",
    "mentioned_users": ["3fa85f64-5717-4562-b3fc-2c963f66afa6", "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"]
}

关键注意点：

• 请求头必须设置Content-Type: application/json，否则DRF无法正确解析数组结构
• UUID字符串必须是标准带连字符的格式，不能省略符号或格式错误
• 禁止将数组包裹在字符串中（比如"mentioned_users": "[uuid1, uuid2]"是错误写法）

如果用表单提交（不推荐REST API场景使用），需将每个UUID作为独立参数传递，格式为mentioned_users=uuid1&mentioned_users=uuid2，但优先推荐JSON格式。

2. 当前实现方案的效率分析 #

你的方案本身属于高效实现，但可以做以下优化：

• PrimaryKeyRelatedField性能：DRF处理many=True的该字段时，会自动用IN查询批量获取用户对象，避免N+1查询问题，这部分性能无瓶颈
• 中间表优化：如果MentionedUser中间表没有额外字段（如@时间、备注），可以直接使用Django默认多对多关联（无需自定义中间表），减少代码复杂度；若必须自定义中间表，记得给user_id和post_id添加联合索引，加速关联查询
• 视图层优化：在获取帖子列表的视图中，使用prefetch_related('mentioned_users')提前加载关联用户，避免序列化阶段重复查询数据库

3. 移动端调用API的提交方式 #

和Web端完全一致，只需遵循REST API的JSON规范：

• iOS端：用Alamofire或URLSession构造请求，将mentioned_users作为[String]类型传入请求体
• Android端：用Retrofit或OkHttp，将mentioned_users作为List<String>类型传入请求体
• 核心要求：确保请求头Content-Type为application/json，UUID字符串格式正确

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