DRF上传图片时ImageField的upload_to生成路径含None如何修复

出现上传路径中实例主键为None的核心原因：通过API接口调用序列化器创建新用户时，ImageField文件的上传、路径生成动作发生在用户实例首次写入数据库之前，此时自增主键还未生成，instance.pk自然为空值。
Django Admin后台新增用户时走内置分步保存逻辑：先将用户基础信息入库拿到主键，再单独处理上传的文件，因此不会出现这个问题。

优先推荐改动最小、逻辑最稳妥的方案：重写序列化器的create方法，分两步完成用户和头像的保存。

具体实现 #

修改serializers.py中的UserSerializer代码，新增create方法：

class UserSerializer(serializers.ModelSerializer):
    def __init__(self, *args, **kwargs):
        exclude = kwargs.pop("exclude", None)
        super().__init__(*args, **kwargs)

        if exclude is not None:
            for field_name in exclude:
                self.fields.pop(field_name)

    password = serializers.CharField(write_only=True)

    def create(self, validated_data):
        # 先把头像文件从校验数据中分离出来
        profile_pic = validated_data.pop("profile_picture", None)
        # 先创建用户基础信息存入数据库，此时会生成主键
        # 调用create_user自动完成密码哈希，避免明文存密码的安全问题
        user = User.objects.create_user(**validated_data)
        # 存在上传头像时，再赋值保存，此时实例已有主键，路径生成正确
        if profile_pic:
            user.profile_picture = profile_pic
            user.save(update_fields=["profile_picture"])
        return user

    class Meta:
        model = User
        exclude = ["deleted", "deleted_by_cascade"]

视图层代码不需要做任何修改，原有注册接口逻辑即可正常运行。

如果不想调整保存逻辑，也可以修改upload_to的路径生成规则，不依赖未持久化的实例主键：比如用用户名、随机UUID作为路径标识，避免出现None的情况。但这种方案需要额外处理文件重名、临时文件迁移的问题，不如第一种方案直接。

注意：不要在profile_picture_path路径生成函数内手动调用instance.save()尝试生成主键，会触发递归保存的异常。

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