drf-yasg中ImageField在Swagger UI不显示无法从请求体上传图片求助

1. 修正代码硬错误 #

你贴的序列化器存在明显的复制粘贴疏漏：两个字段都写为profile_img，完全遗漏了cover_img字段。Python类定义中同名字段会被后者直接覆盖，最终序列化器内只剩一个profile_img字段，Swagger自然无法渲染出第二个图片上传项。
修正后的序列化器代码：

# my_serializer.py
from rest_framework import serializers

class MySerializer(serializers.Serializer):
    # 对齐视图取值逻辑，根据业务调整字段必填规则
    profile_img = serializers.ImageField(required=False)
    cover_img = serializers.ImageField(required=False)

2. 修复Swagger与请求解析核心配置 #

这是最高发的新手踩坑点： 很多人以为只要序列化器里定义了ImageField，Swagger就会自动渲染文件上传控件，实际上缺少对应配置的话，Swagger会默认按application/json格式渲染请求体，根本不会显示文件上传入口；同时DRF如果未配置对应解析器，就算你用form-data传了文件，request.FILES也会是空值。
修正后的视图代码：

# view.py
from rest_framework.decorators import api_view, parser_classes
from rest_framework.parsers import MultiPartParser, FormParser
from drf_yasg.utils import swagger_auto_schema
from .my_serializer import MySerializer

# 装饰器按从下到上的执行顺序排列，禁止乱序
@swagger_auto_schema(
    method='post',
    request_body=MySerializer,
    # 明确指定接口接收multipart/form-data格式，触发Swagger的文件上传控件渲染
    consumes=['multipart/form-data']
)
@api_view(['POST'])
# 配置请求解析器，支持处理文件上传格式的请求
@parser_classes([MultiPartParser, FormParser])
def image(request):
    # 走序列化器统一校验逻辑，避免直接裸取FILES
    serializer = MySerializer(data=request.data)
    serializer.is_valid(raise_exception=True)
    
    profile_img = serializer.validated_data.get('profile_img')
    cover_img = serializer.validated_data.get('cover_img')
    # 后续业务逻辑...

3. 兜底环境校验 #

按以下顺序排查遗漏配置：

• 检查项目settings.py是否配置了MEDIA_URL、MEDIA_ROOT路径，否则ImageField做文件类型校验时会直接报错
• 开发环境下确认项目路由是否配置了media静态文件的访问规则（不影响上传功能，但会导致后续无法访问已上传的图片）
• 测试时无论使用Swagger还是Postman，都要选择form-data格式提交请求，不要选JSON、Binary格式，且提交的文件字段key要和序列化器定义的字段名完全一致
• 所有代码修正完成后，强制刷新Swagger页面，确认两个图片字段已经从普通文本输入框变为文件选择上传控件，此时即可完成图片上传操作

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