Django REST Framework中Multipart表单多图片上传失败问题排查

看起来你在处理多对多关系下的文件上传时遇到了几个典型问题，我来一步步帮你解决：

先理清错误原因 #

1. "Invalid boundary in multipart: None" 错误 #

这个错误是因为你错误地使用了Raw JSON格式并手动设置multipart/form-data头。multipart/form-data请求需要客户端（比如Postman或浏览器）自动生成boundary分隔符来区分不同的表单字段，手动设置头时不会带上这个边界，导致服务器无法解析请求。

另外在可浏览API里输入本地图片路径也是错误的——ImageField需要上传真实的文件，而不是字符串格式的本地路径，这种写法不仅不会上传文件，还会触发请求格式解析错误。

2. Form-data下公告创建成功但图片未上传 #

你的嵌套序列化器AnnouncementSerializer虽然声明了photo字段，但DRF默认不会自动处理嵌套关系中的文件上传——它不会自动创建Photo实例并关联到新创建的Announcement对象，需要你手动编写逻辑来处理这部分。

解决方案步骤 #

步骤1：修正序列化器逻辑 #

修改Serializers.py，在AnnouncementSerializer中添加create方法，手动处理Photo的创建和关联：

from rest_framework import serializers
from .models import Announcement, Photo

class PhotoSerializer(serializers.ModelSerializer):
    class Meta:
        model = Photo
        fields = ('name', 'image')

class AnnouncementSerializer(serializers.ModelSerializer):
    photo = PhotoSerializer(many=True, required=False)
    # parameters = ParameterSerializer(many=True, required=False)  # 保留你原有的ParameterSerializer，如果需要的话

    class Meta:
        model = Announcement
        fields = ['id', 'name', 'address', 'date', 'price', 'description', 'author', 'photo']

    def create(self, validated_data):
        # 从验证后的数据中取出photo列表（如果存在）
        photos_data = validated_data.pop('photo', [])
        # 创建公告对象
        announcement = Announcement.objects.create(**validated_data)
        # 遍历图片数据，创建Photo实例并关联到公告
        for photo_data in photos_data:
            photo = Photo.objects.create(**photo_data)
            announcement.photo.add(photo)
        return announcement

步骤2：确保视图配置正确 #

你的AnnouncementCreate视图已经设置了正确的解析器，只需要保留即可（无需修改PhotoViewSet，因为我们直接在公告创建时处理图片上传）：

from rest_framework.generics import CreateAPIView
from .models import Announcement
from .serializers import AnnouncementSerializer

class AnnouncementCreate(CreateAPIView):
    queryset = Announcement.objects.all()
    serializer_class = AnnouncementSerializer
    parser_classes = (MultiPartParser, FormParser)

    def perform_create(self, serializer):
        # 自动设置当前登录用户为公告作者
        serializer.save(author=self.request.user)

步骤3：正确构造请求 #

Postman请求方式

1. 选择POST请求，填入你的公告创建API URL
2. 切换到form-data标签（不要用Raw JSON！）
3. 添加以下字段：
   • name: tractor
   • address: any
   • price: 100
   • （可选）如果要手动指定作者，添加author: 17；如果用当前登录用户，忽略这个字段
   • 上传图片：
     • 第一个图片：键填photo[].name，值设为"tractor"；再添加键photo[].image，类型选择File，然后选择本地图片文件
     • 第二个图片：重复上述操作，键同样用photo[].name和photo[].image，填入对应名称和选择另一个文件
4. 不要手动修改Content-Type头，Postman会自动生成正确的multipart/form-data; boundary=xxx头

DRF可浏览API请求方式

打开AnnouncementCreate的API页面，你会看到自动生成的表单：

• 填写name、address、price等基础字段
• 找到photo字段区域，点击"Add"按钮添加多个图片项
• 每个图片项中，填写name，然后点击image字段的文件选择按钮，选择本地图片
• 最后点击"POST"按钮提交

额外注意事项 #

1. 确保你的nameFile上传路径函数正常工作，比如：

   def nameFile(instance, filename):
       # 生成唯一的上传路径，避免文件名冲突
       return f'photos/{instance.name}_{filename}'
   

2. 在settings.py中正确配置媒体文件路径：

   MEDIA_ROOT = BASE_DIR / 'media'
   MEDIA_URL = '/media/'
   

3. 在项目的urls.py中添加媒体文件的访问路由：

   from django.conf import settings
   from django.conf.urls.static import static
   
   urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
   

这样调整后，你就能正常创建带多张图片的公告了。

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