Django导入Excel时如何处理UNIQUE约束重复并返回错误提示

现有代码存在的核心问题 #

• 注释掉的重复校验逻辑完全不成立：Student.student_id是模型字段对象，Student(data[3])是错误的实例化写法，根本无法匹配数据库中已存在的学号，且你取的data[3]索引错误，按模型字段顺序student_id对应Excel行的索引是2，不是3。
• 成功提示触发时机错误：文件格式校验通过后立刻返回导入成功，此时数据还未写入数据库，提示完全不符合实际执行结果。
• 逐行按位置索引实例化模型的写法鲁棒性极差，一旦Excel列顺序调整就会出现全量数据错写，且未捕获数据库唯一约束抛出的异常，遇到重复学号会直接触发500错误。
• 没有用到django-import-export自带的导入校验、错误收集能力，重复造轮子还容易出问题。

推荐实现方案 #

优先使用django-import-export原生能力实现，代码更简洁，错误提示更清晰：

第一步：配置StudentResource #

在app目录下新建resources.py，配置导入规则和重复校验逻辑：

from import_export import resources
from .models import Student
from django.core.exceptions import ValidationError

class StudentResource(resources.ModelResource):
    class Meta:
        model = Student
        import_id_fields = ["student_id"]  # 指定学号作为导入唯一判定字段
        skip_unchanged = False
        report_skipped = True

    def before_import_row(self, row, **kwargs):
        # 逐行导入前校验学号是否已存在
        sid = row.get("student_id")
        if Student.objects.filter(student_id=sid).exists():
            raise ValidationError(f"学号[{sid}]已在系统中存在，请勿重复导入")

第二步：重写上传视图 #

替换原有视图逻辑，使用Resource自带的导入方法自动收集错误：

from django.contrib import messages
from django.shortcuts import render, redirect
from tablib import Dataset
from .resources import StudentResource

def simple_upload(request):
    if request.method == "POST":
        student_resource = StudentResource()
        dataset = Dataset()
        upload_file = request.FILES["myfile"]

        # 校验文件格式
        if not upload_file.name.endswith(".xlsx"):
            messages.error(request, "仅支持导入.xlsx格式的Excel文件")
            return redirect("upload")
        
        # 加载导入数据
        imported_data = dataset.load(upload_file.read(), format="xlsx")
        # 执行导入，收集所有行错误
        import_result = student_resource.import_data(
            imported_data,
            dry_run=False,
            collect_errors=True
        )

        # 处理导入错误
        if import_result.has_errors():
            err_list = []
            for row_num, errors in import_result.row_errors():
                for err in errors:
                    err_list.append(f"第{row_num}行错误：{str(err.error)}")
            messages.error(request, "导入失败：<br>" + "<br>".join(err_list))
            return redirect("upload")
        
        # 全部校验通过后返回成功提示
        messages.success(request, "学生数据导入成功")
        return redirect("student_list")
    return render(request, "import.html")

轻量改法（保留原有循环逻辑） #

如果不想调整现有代码结构，仅修正校验逻辑和异常捕获也可实现需求：

from django.db import IntegrityError

def simple_upload(request):
    if request.method == "POST":
        dataset = Dataset()
        upload_file = request.FILES["myfile"]

        if not upload_file.name.endswith("xlsx"):
            messages.error(request, "仅支持导入.xlsx格式的Excel文件")
            return redirect("upload")

        imported_data = dataset.load(upload_file.read(), format="xlsx")
        import_success = True
        err_msg = ""

        for row_idx, row in enumerate(imported_data, start=2):  # 行号从2开始算，跳过表头
            # 用关键字参数传值，避免索引错位导错数据
            stu_obj = Student(
                school=row[0],
                district=row[1],
                student_id=row[2],
                stu_class=row[3],
                name=row[4],
                date=row[5],
                sex=row[6],
                place_of_birth=row[7],
                ethnic=row[8],
                location=row[9],
                phone_number=row[10],
                total_grade_1=row[11],
                total_grade_2=row[12],
                total_grade_3=row[13],
                total_grade_4=row[14],
                total_grade_5=row[15],
                total_5_years=row[16],
                plus=row[17] if row[17] else 0,
                total_all=row[18],
                decripsion=row[19]
            )
            try:
                stu_obj.save()
            except IntegrityError:
                import_success = False
                err_msg = f"导入终止：第{row_idx}行学号{stu_obj.student_id}已存在"
                break
        
        if not import_success:
            messages.error(request, err_msg)
            return redirect("upload")
        
        messages.success(request, "学生数据导入成功")
        return redirect("student_list")
    return render(request,"import.html")

其他需要修正的问题 #

• 模型中的__str__方法缩进错误，目前定义在Student类外部，需要缩进4个空格放到类内部才能生效。
• 模型字段decripsion存在拼写错误，正确拼写为description，未上线前建议修正，避免后续业务代码持续出现拼写问题。
• 所有允许为空的整数字段建议加上null=True属性，否则导入空值时容易触发字段校验错误。

内容的提问来源于stack exchange，提问作者Dũng Nguyễn Văn