Django原生User模型批量导入xlsx/csv用户出现AlreadyRegistered错误如何解决

1. 修复import-export注册报错 #

你遇到的AlreadyRegistered报错是因为Admin注册逻辑顺序错误+重复注册：Django默认已经把User模型注册到了自带的UserAdmin，你需要先注销默认注册，再注册自定义的ImportExportModelAdmin，同时不要同时用@admin.register装饰器和手动admin.site.register两种注册方式。

修改后的admin.py代码如下：

from django.contrib import admin
from django.contrib.auth.models import User
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from import_export.admin import ImportExportModelAdmin
from import_export import resources
# 导入你自己写的注册表单
from .forms import RegisterForm

# 第一步：先注销Django默认的User模型注册
admin.site.unregister(User)

# 可选：自定义导入资源，可指定导入字段、处理关联Profile逻辑
class UserResource(resources.ModelResource):
    class Meta:
        model = User
        # 配置要导入的字段，和你的csv/xlsx表头一一对应
        fields = ('id', 'username', 'email', 'last_name', 'first_name', 'password')

    # 自动处理明文密码加密
    def before_save_instance(self, instance, using_transactions, dry_run):
        if instance.password and not instance.password.startswith('pbkdf2_sha256$'):
            instance.set_password(instance.password)
        super().before_save_instance(instance, using_transactions, dry_run)

    # 若导入表包含projekt等Profile字段，可在此处完成关联赋值
    def after_save_instance(self, instance, using_transactions, dry_run):
        super().after_save_instance(instance, using_transactions, dry_run)
        # 示例：如果导入表有projekt_id列，直接赋值即可
        # instance.profile.projekt_id = self.get_import_value('projekt_id')
        # instance.profile.save()

# 注册自定义的UserAdmin，继承原有UserAdmin保留原生用户管理功能，同时继承导入导出能力
@admin.register(User)
class UserAdmin(ImportExportModelAdmin, BaseUserAdmin):
    resource_classes = [UserResource]
    # 复用你已写好的注册表单
    add_form = RegisterForm

2. 可选：更稳妥的批量导入方案（自定义管理命令） #

如果不想修改现有Admin配置，避免影响线上站点的后台功能，可直接写一次性导入命令，用pandas/tablib读取文件批量创建用户，对现有逻辑无侵入。

首先在你的应用目录下创建层级目录：your_app/management/commands/，目录下新增空文件__init__.py，再新建import_users.py，代码如下：

import pandas as pd
from django.core.management.base import BaseCommand
from django.contrib.auth.models import User

class Command(BaseCommand):
    help = '从xlsx/csv文件批量导入用户'

    def add_arguments(self, parser):
        parser.add_argument('file_path', type=str, help='导入文件的绝对/相对路径，支持csv、xlsx格式')

    def handle(self, *args, **options):
        file_path = options['file_path']
        # 读取导入文件
        if file_path.endswith('.csv'):
            df = pd.read_csv(file_path)
        else:
            df = pd.read_excel(file_path)
        
        success_count = 0
        for _, row in df.iterrows():
            try:
                # 校验用户名唯一性
                if User.objects.filter(username=row['username']).exists():
                    self.stdout.write(self.style.WARNING(f"用户名 {row['username']} 已存在，跳过该行"))
                    continue
                # 创建用户，post_save信号会自动生成对应Profile实例
                user = User.objects.create(
                    username=row['username'],
                    email=row.get('email', ''),
                    last_name=row.get('last_name', ''),
                    first_name=row.get('first_name', '')
                )
                # 明文密码加密
                user.set_password(row['password'])
                user.save()
                # 若导入表包含projekt字段，可直接给Profile赋值
                user.profile.projekt_id = row.get('projekt_id', 1)
                user.profile.save()
                success_count +=1
            except Exception as e:
                self.stdout.write(self.style.ERROR(f"导入行失败，行内容：{row.to_dict()}，错误原因：{str(e)}"))
        
        self.stdout.write(self.style.SUCCESS(f"导入任务完成，共成功导入 {success_count} 个用户"))

使用时直接在项目根目录执行命令：python manage.py import_users 你的文件路径即可，测试阶段先用小批量数据验证，没问题再操作生产数据。

注意事项 #

• 导入前务必备份生产数据库，避免数据异常
• 如果导入文件中的密码已经是Django加密后的格式，不需要调用set_password方法
• 提前对用户名、邮箱等唯一字段去重，减少导入失败概率

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