运行django-seed填充脚本报ImproperlyConfigured错误的原因与解决方法

触发这个异常的根本原因是直接运行独立seed.py脚本时，Django运行环境未完成初始化：脚本没有指定Django项目的配置文件路径，Django无法加载INSTALLED_APPS、数据库连接等核心配置，自然无法正常加载模型类、执行ORM相关操作。
Django的ORM、模型相关逻辑都要求运行在已加载配置的Django上下文中，既没有配置DJANGO_SETTINGS_MODULE环境变量，也没有手动调用配置初始化接口就直接导入模型，就会抛出这个配置缺失的错误。

有两种常用的解决方式，优先推荐第一种，稳定性最高：

• 方案1：将数据填充逻辑封装为Django自定义管理命令
  这是Django生态里执行离线脚本的标准做法，不需要手动处理环境初始化，Django会自动加载所有项目配置：

  1. 在你的业务app（即报错路径里的app_worker）目录下新建层级目录management/commands，两个目录下都要放置空的__init__.py文件，确保Python能识别为包
  2. 在commands目录下新建seed.py文件，写入以下代码：

  from django.core.management.base import BaseCommand
  from django_seed import Seed
  from app_worker.models import Employee
  
  class Command(BaseCommand):
      help = "批量生成Employee测试数据"
  
      def handle(self, *args, **kwargs):
          seeder = Seed.seeder()
          seeder.add_entity(Employee, 5)
          inserted_pks = seeder.execute()
          self.stdout.write(self.style.SUCCESS(f"测试数据生成完成，插入记录主键：{inserted_pks}"))
  

  3. 回到manage.py所在的项目根目录，执行命令python3 manage.py seed即可正常运行。

• 方案2：修改现有独立脚本，手动初始化Django环境
  如果需要保留独立脚本的运行形式，只要在导入模型前完成Django环境初始化即可：

  1. 将seed.py移动到manage.py同级的项目根目录，避免模块路径解析错误
  2. 修改seed.py代码，在最顶部加入环境初始化逻辑：

  import os
  import django
  
  # 替换为你自己项目的settings模块路径
  os.environ.setdefault("DJANGO_SETTINGS_MODULE", "myproject.settings")
  django.setup()
  
  # 环境初始化完成后再导入依赖、执行业务逻辑
  from django_seed import Seed
  from app_worker.models import Employee
  
  seeder = Seed.seeder()
  seeder.add_entity(Employee, 5)
  inserted_pks = seeder.execute()
  print(f"数据插入完成，生成记录主键：{inserted_pks}")
  

  注意导入模型时要带上app前缀，使用from app_worker.models import Employee的形式，不要直接写from models import Employee，否则会触发模块找不到的错误。修改完成后执行python3 seed.py即可正常运行。

前置检查：运行前请确认django_seed和你的业务appapp_worker都已经添加到项目settings.py的INSTALLED_APPS列表中，否则会出现模块找不到的报错。

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