如何在Django REST Framework(DRF)中让multipart/formdata转换为适配ModelSerializer的QueryDict格式

我来帮你解决这个DRF ModelSerializer无法识别multipart/form-data中列表字段的问题，本质是DRF对表单数据的数组解析规则和你当前的索引式格式不匹配导致的，下面分方案说明：

解决方案1：调整前端（Next.js）FormData构造格式（推荐） #

DRF的MultiPartParser和FormParser默认识别重复字段名作为数组，而不是带索引的brands[0]这种格式。你需要修改Next.js中构建FormData的逻辑：

基础数组字段（如brands、option_types） #

直接多次调用append同一个字段名，DRF会自动解析为数组：

const formData = new FormData();
formData.append('name', 'Test Product');

// 处理brands数组：重复append同一个键
[1, 2].forEach(brandId => formData.append('brands', brandId));
// 处理option_types数组
[1].forEach(typeId => formData.append('option_types', typeId));

嵌套数组对象（如product_variants） #

因为你用了WritableNestedModelSerializer，嵌套的数组对象需要用索引+点分隔键的格式来标识层级：

// 处理第一个product_variant的option_values数组
formData.append('product_variants[0].option_values', 1);
formData.append('product_variants[0].option_values', 2);
// 如果有多个product_variants，继续用product_variants[1].xxx的格式

这样构造的FormData对应的QueryDict会是：

<QueryDict: {
    'name': ['Test Product'],
    'brands': ['1', '2'],
    'option_types': ['1'],
    'product_variants[0].option_values': ['1', '2']
}>

此时你的ProductDetailAdminSerializer就能正常识别这些数组字段了，validate_option_types里也能拿到正确的数组数据。

解决方案2：后端手动转换QueryDict格式（如果前端无法修改） #

如果前端没法调整格式，你可以在DRF视图中手动把索引式的QueryDict转换成DRF期望的结构：

编写转换工具函数 #

def transform_indexed_querydict(query_dict):
    """将带索引的QueryDict转换为DRF Serializer期望的格式"""
    transformed = {}
    for key, values in query_dict.lists():
        # 处理类似brands[0]、product_variants[0]option_values[0]的键
        if '[' in key and ']' in key:
            # 拆分基础键和索引部分
            base_key, rest = key.split('[', 1)
            idx_str, nested_key = rest.split(']', 1)
            idx = int(idx_str)
            
            # 初始化基础键的数组
            if base_key not in transformed:
                transformed[base_key] = []
            # 确保数组长度足够，填充空字典
            while len(transformed[base_key]) <= idx:
                transformed[base_key].append({})
            
            # 处理嵌套键（如option_values[0]）
            if '[' in nested_key and ']' in nested_key:
                nested_base, nested_idx_str = nested_key.split('[', 1)
                nested_idx = int(nested_idx_str.rstrip(']'))
                # 初始化嵌套键的数组
                if nested_base not in transformed[base_key][idx]:
                    transformed[base_key][idx][nested_base] = []
                transformed[base_key][idx][nested_base].extend(values)
            else:
                # 非嵌套的字段，直接赋值（如果是多个值则转数组）
                if len(values) == 1:
                    transformed[base_key][idx][nested_key] = values[0]
                else:
                    transformed[base_key][idx][nested_key] = values
        else:
            # 普通字段，单个值取第一个，多个值保留数组
            transformed[key] = values[0] if len(values) == 1 else values
    return transformed

在视图中使用转换函数 #

def create(self, request, *args, **kwargs):
    # 转换QueryDict格式
    processed_data = transform_indexed_querydict(request.data)
    serializer = ProductDetailAdminSerializer(data=processed_data)
    if serializer.is_valid():
        serializer.save()
        return JsonResponse(serializer.data)
    return JsonResponse(serializer.errors, status=400)

这个函数会把你当前的索引式QueryDict转换成DRF Serializer能识别的嵌套数组结构，解决validate_option_types返回空列表的问题。

原理说明 #

DRF的表单解析器（MultiPartParser/FormParser）和JSON解析器的行为不同：

• JSON格式原生支持数组和嵌套对象，所以你用JSON Content-Type时能正常工作
• 表单数据没有原生的数组/嵌套结构，DRF约定重复字段名代表数组，索引+点分隔代表嵌套对象的数组项

你之前用的brands[0]这种索引式格式是某些前端库的默认行为，但DRF不会自动将其解析为数组，除非是嵌套对象的场景（比如product_variants[0].name）。

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