运行Django种子数据脚本时遇ModuleNotFoundError: No module named 'backend'

问题概述 #

运行Django项目的种子数据脚本时，触发ModuleNotFoundError: No module named 'backend.api'错误。已尝试重构项目结构、使用相对导入（如from ..models import BaseModel），但问题未解决，目标是成功运行脚本填充测试数据库。

已提供的关键信息：

• 完整错误回溯信息
• settings.py中INSTALLED_APPS配置内容
• 项目文件结构

排查步骤 #

1. 确保项目根目录在Python路径中 #

种子脚本运行时，Python可能无法识别项目包结构。在脚本开头添加代码，将项目根目录加入sys.path：

import sys
import os

# 根据脚本实际位置调整路径，示例假设脚本在项目根下的scripts文件夹
PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(PROJECT_ROOT)

2. 检查INSTALLED_APPS配置准确性 #

确认backend.api已正确注册到INSTALLED_APPS，格式如下：

INSTALLED_APPS = [
    # 其他默认应用
    'backend.api',
    # 若api是backend下的子应用，需匹配其apps.py中name字段的值
]

同时检查api应用的apps.py，确保name字段与INSTALLED_APPS中的条目一致（如name = 'backend.api'或name = 'api'）。

3. 修正导入路径逻辑 #

• 放弃相对导入，改用绝对导入。例如BaseModel在backend.api.models中，直接写：

  from backend.api.models import BaseModel
  

• 若脚本不在项目根目录，确保导入路径从项目根开始，或通过sys.path调整让Python能找到backend包。

4. 验证项目结构合规性 #

确保每个包目录下存在__init__.py文件（空文件即可），示例结构：

project_root/
├── backend/
│   ├── __init__.py
│   ├── api/
│   │   ├── __init__.py
│   │   ├── models.py
│   │   └── apps.py
│   └── settings.py
└── scripts/
    └── seed_data.py

缺少__init__.py会导致Python无法识别为可导入包。

5. 规范脚本运行方式 #

推荐通过Django的manage.py加载环境后运行脚本，避免路径问题：

python manage.py shell < scripts/seed_data.py

或把脚本改造成Django自定义命令：在api应用下创建management/commands/seed_data.py，之后直接运行python manage.py seed_data，自动适配Django环境。

6. 核对Python环境一致性 #

确认运行脚本的Python环境与Django项目使用的环境一致：

which python  # 查看当前Python解释器路径
pip list  # 确认Django已安装在当前环境

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