Django-import-export导入ForeignKey字段仅首个值成功问题排查

首先咱们先定位问题根源：你遇到的报错Error: GeoMaster matching query does not exist.，大概率是因为Excel中的geo_master_id是浮点数类型（比如2.0），而数据库里GeoMaster的id是整数类型，导致匹配时无法找到对应条目——只有1.0能成功是因为它转成整数后刚好匹配第一条数据，而其他浮点数在默认的ForeignKeyWidget处理下无法正确匹配整数ID。

下面是具体的解决步骤：

方案1：重写ForeignKeyWidget的clean方法处理类型转换 #

修改你的自定义Widget，在清理输入值时把浮点数转成整数，确保和数据库ID类型一致：

from .models import Country, GeoMaster
from import_export import resources, fields
from import_export.widgets import ForeignKeyWidget

class GeoMasterForeignKeyWidget(ForeignKeyWidget):
    def clean(self, value, row=None, *args, **kwargs):
        # 处理Excel中可能出现的浮点数（如2.0）转整数
        if value is not None:
            try:
                # 先转成float再转int，兼容字符串形式的数字（如"2.0"）
                value = int(float(value))
            except (ValueError, TypeError):
                # 如果转换失败，保持原value，后续会正常抛出不存在的错误
                pass
        return super().clean(value, row, *args, **kwargs)

class CountryResource(resources.ModelResource):
    geo_master_id = fields.Field(
        column_name='geo_master_id',
        attribute='geo_master_id',
        widget=GeoMasterForeignKeyWidget(GeoMaster, 'id')
    )
    class Meta:
        model = Country
        import_id_fields = ['country_name']
        fields = ('id', 'country_name', 'geo_master_id')

方案2：修改get_queryset方法处理类型转换 #

如果你更倾向于在查询阶段处理，也可以调整自定义Widget的get_queryset方法：

class GeoMasterForeignKeyWidget(ForeignKeyWidget):
    def get_queryset(self, value, row):
        try:
            # 提取并转换geo_master_id为整数
            geo_id = int(float(row["geo_master_id"]))
        except (ValueError, TypeError):
            # 转换失败返回空查询集，触发不存在的错误
            return self.model.objects.none()
        return self.model.objects.filter(id=geo_id)

额外检查点 #

• 确认数据库中确实存在id=2（及其他你要导入的ID）的GeoMaster条目，避免真的不存在数据导致报错。
• 检查Excel文件中的geo_master_id列，确保没有额外的空格或非数字字符（比如" 2.0 "这种带空格的情况），如果有可以在clean方法里加上value.strip()处理。

这样修改后，应该就能正确匹配所有GeoMaster的ID，而不仅仅是首个条目了。

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