Django DRF保存base64图片列表至ImageField数组报错解决方案

报错核心是两个逻辑不匹配：

1. DRF自带的ImageField序列化字段默认只接收multipart/form-data格式上传的文件对象，无法直接解析JSON请求里的base64字符串，因此触发「提交数据不是文件」的校验错误。
2. 你当前使用ModelSerializer自动映射模型字段，没有对images列表内的base64内容做逐个解码、转文件对象的逻辑，无法满足ImageField的输入要求。

另外你当前模型层用ArrayField嵌套ImageField的写法本身可以正常运行——Django的ImageField本质是在数据库存文件路径字符串，PostgreSQL的文本数组支持存储这类值，不需要修改模型定义。

你只需要修改serializers.py，自定义支持base64解析的图片字段，再用列表字段包裹实现逐个解码即可，视图层和模型层无需改动。

import base64
import uuid
from django.core.files.base import ContentFile
from rest_framework import serializers
from .models import Hotel


# 自定义支持base64输入的图片字段
class Base64ImageField(serializers.ImageField):
    def to_internal_value(self, data):
        # 兼容带data:image/xxx;base64,前缀的标准base64图片格式
        if isinstance(data, str) and data.startswith("data:image"):
            img_format, b64_content = data.split(";base64,")
            img_ext = img_format.split("/")[-1]
            # 解码base64内容，生成随机文件名避免重名覆盖
            file_data = ContentFile(
                base64.b64decode(b64_content),
                name=f"{uuid.uuid4().hex}.{img_ext}"
            )
            return super().to_internal_value(file_data)
        # 兼容普通文件对象上传的场景
        return super().to_internal_value(data)


class HotelsSerializer(serializers.ModelSerializer):
    # 重写images字段，指定列表内每一项都走自定义base64解析逻辑
    images = serializers.ListField(
        child=Base64ImageField(allow_empty_file=False),
        required=False
    )

    class Meta:
        model = Hotel
        fields = (
            "id", "name", "stars", "address", "description", "number_of_floors",
            "number_of_rooms", "room_delivery_time", "room_empty_time",
            "images", "features"
        )

改完之后接口就可以正常接收base64图片列表，自动完成解码、文件上传到hotel_images/目录、路径存入数据库的全流程。

• 不推荐长期使用数组字段存图片路径：如果后续需要给图片加封面标记、排序权重、图片描述、上传时间等属性，数组字段几乎没有扩展空间。更合理的设计是单独新建HotelImage关联表，用外键绑定Hotel模型，表内设置image（ImageField）、is_cover（布尔值，标记封面）、sort（整数字段，排序用）等字段，序列化时用嵌套序列化器处理图片列表，后续维护成本低很多。
• 优先使用标准文件上传：如果前端可以调整请求格式，优先用multipart/form-data传文件列表，比base64编码的请求体积小30%左右，传输和解析性能更好；base64编码会额外增加1/3的文件体积，高并发场景下会浪费带宽和服务端解码资源。
• 加校验限制：如果坚持用base64传图，要在字段上加单图大小限制、支持格式限制，避免超大文件、非法格式的请求拖垮服务。

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