Django Import-Export导入含User外键数据失败，报错NOT NULL约束

阿华AIGC实验室

2026-5-14

解决Django Import-Export用用户名关联User外键的导入错误

嘿，我碰到过类似的问题！你遇到的NOT NULL constraint failed: medialog_mediaentry.creator_id错误，说白了就是导入时程序没能通过你给的用户名找到对应的User实例，导致creator这个必填外键字段是空的，触发了数据库的非空约束。我来给你梳理几个可行的解决方案：

先排查基础问题

在改代码之前，先确认两个关键点：

你的导入文件（CSV/Excel）里的creator列值是不是完全匹配系统中已存在的用户名？注意大小写、前后空格这些细节，ForeignKeyWidget默认是精确匹配的。
有没有可能导入的用户名在你的Django系统里根本不存在？这种情况肯定会找不到User，导致creator_id为空。

默认的ForeignKeyWidget有时候在批量导入或预览时可能有匹配问题，我们可以自定义一个Widget来强化查找逻辑，比如支持忽略大小写：

from import_export.widgets import ForeignKeyWidget
from django.contrib.auth.models import User
from import_export import resources, fields

class UserForeignKeyWidget(ForeignKeyWidget):
    def get_queryset(self, value, row, *args, **kwargs):
        # 用__iexact忽略大小写匹配用户名，你也可以改成精确匹配的__exact
        return User.objects.filter(username__iexact=value)

class MediaEntryResource(resources.ModelResource):
    creator = fields.Field(
        column_name='creator',
        attribute='creator',
        widget=UserForeignKeyWidget(model=User, field='username')
    )
    
    class Meta:
        model = MediaEntry
        fields = ('id', 'media_number', 'creator',)
        # 加上这两个配置，方便预览时跳过未修改的行，同时报告跳过情况
        skip_unchanged = True
        report_skipped = True

方案2：处理无效用户名（可选）

如果你的导入数据里可能包含系统中不存在的用户名，可以根据业务需求选择两种处理方式：

选项A：跳过无效行

在资源类里重写before_import_row方法，提前检查用户名是否存在，不存在就标记跳过该行：

class MediaEntryResource(resources.ModelResource):
    creator = fields.Field(
        column_name='creator',
        attribute='creator',
        widget=ForeignKeyWidget(model=User, field='username')
    )
    
    def before_import_row(self, row, **kwargs):
        username = row.get('creator')
        if not username or not User.objects.filter(username=username).exists():
            # 标记该行跳过，不会导入
            kwargs['skip'] = True
            # 可以给该行加错误提示，预览时能看到
            row['__error__'] = f"用户名 '{username}' 不存在，已跳过该行"
    
    class Meta:
        model = MediaEntry
        fields = ('id', 'media_number', 'creator',)

选项B：自动创建新用户（谨慎使用）

如果业务允许自动创建不存在的用户，可以重写Widget的clean方法，用get_or_create来自动生成用户：

class AutoCreateUserWidget(ForeignKeyWidget):
    def clean(self, value, row=None, *args, **kwargs):
        if value:
            # 找不到用户就自动创建，这里可以根据需求添加默认邮箱、密码等
            user, _ = User.objects.get_or_create(username=value)
            return user
        return super().clean(value, row, *args, **kwargs)

class MediaEntryResource(resources.ModelResource):
    creator = fields.Field(
        column_name='creator',
        attribute='creator',
        widget=AutoCreateUserWidget(model=User, field='username')
    )
    
    class Meta:
        model = MediaEntry
        fields = ('id', 'media_number', 'creator',)