Django 1.10：批量导入数据创建对象前的模型验证问题

嘿，我刚好在Django 1.10里处理过几乎一模一样的批量导入场景——用ModelSerializer确实比手写一堆if判断靠谱多了，咱们一步步把这个流程理清楚，顺便解决你可能遇到的坑：

1. 先定义你的模型和对应的ModelSerializer #

假设你有个要导入的模型，比如：

from django.db import models

class Product(models.Model):
    name = models.CharField(max_length=100)
    price = models.DecimalField(max_digits=10, decimal_places=2)
    description = models.TextField(blank=True)

对应的Serializer要注意两点：一是要适配批量处理的逻辑，二是确保默认的字段验证生效（比如CharField的max_length会自动检查）：

from rest_framework import serializers
from .models import Product

class ProductSerializer(serializers.ModelSerializer):
    class Meta:
        model = Product
        fields = ['name', 'price', 'description']

    def create(self, validated_data):
        # 批量创建时会循环调用这个方法，后续也可以用bulk_create优化性能
        return Product.objects.create(**validated_data)

2. 解析上传的文件数据 #

比如用户上传的是CSV文件，先把文件内容解析成字典列表（要和Serializer字段名对应）：

import csv
from django.http import HttpResponse

def import_products(request):
    if request.method == 'POST' and request.FILES.get('import_file'):
        file = request.FILES['import_file']
        decoded_file = file.read().decode('utf-8').splitlines()
        reader = csv.DictReader(decoded_file)
        # 把CSV行转成字典列表，注意表头要和Serializer字段名匹配
        data_list = list(reader)
        # 接下来处理验证和创建逻辑

3. 批量验证并收集错误 #

这是核心部分，用Serializer的many=True处理批量数据，关闭raise_exception以便收集所有错误：

# 初始化Serializer，传入批量数据
        serializer = ProductSerializer(data=data_list, many=True)
        # 不抛出异常，而是返回验证结果，方便收集所有错误
        serializer.is_valid(raise_exception=False)

        # 收集详细错误信息，关联CSV行号（从第二行开始是数据）
        errors = []
        for idx, error in enumerate(serializer.errors):
            if error:
                errors.append({
                    'row': idx + 2,  # 加2是因为CSV第一行是表头
                    'invalid_fields': error
                })

        # 处理通过验证的数据
        valid_data = serializer.validated_data
        if valid_data:
            # 用bulk_create提升批量创建性能，比逐个调用create快很多
            Product.objects.bulk_create([Product(**item) for item in valid_data])
            # 也可以用serializer.save()，但会逐个调用create方法，数据量大时不推荐

        # 返回处理结果，把成功数量和错误详情反馈给用户
        return HttpResponse(f"成功导入{len(valid_data)}条数据，{len(errors)}条数据无效：{errors}")

4. 自定义额外验证逻辑 #

如果默认的模型验证不够，比如要检查价格不能为负，直接在Serializer里加自定义验证方法：

class ProductSerializer(serializers.ModelSerializer):
    # ... 之前的代码 ...

    # 单个字段的自定义验证
    def validate_price(self, value):
        if value <= 0:
            raise serializers.ValidationError("价格不能为负数")
        return value

    # 跨字段验证，比如名称和描述不能同时为空
    def validate(self, data):
        if not data.get('name') and not data.get('description'):
            raise serializers.ValidationError("名称和描述不能同时为空")
        return data

你可能遇到的ModelSerializer问题及解决 #

• 批量创建性能问题：默认的serializer.save()会逐个调用create方法，数据量大时建议用bulk_create优化，就像示例里那样。
• 字段名不匹配：如果CSV表头和模型字段名不一致，在解析时要做映射（比如把CSV里的"商品名称"转成模型的"name"）。
• 空值处理：如果模型字段不允许为空，要确保CSV对应字段有值，或者在Serializer里显式设置required=True强化验证。

这样下来，所有字段的验证（包括Django模型自带的和你自定义的）都会自动执行，错误信息也能精准定位到每一行的具体字段，比手写if判断健壮太多啦！

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