Django项目services.py导入模型报错及模块找不到问题求助

原因分析 #

直接在非Django启动流程（比如单独运行services.py）中导入模型，Django未完成初始化会触发配置未加载异常；设置DJANGO_SETTINGS_MODULE时路径错误，会导致找不到项目配置模块。

解决方案步骤 #

1. 配置正确的Django初始化代码 #

在services.py开头添加以下代码，确保项目根目录被加入Python路径：

import os
import sys
import django

# 假设你的项目结构是：
# project_root/
# ├─ my_site/
# │  ├─ settings.py
# │  └─ ...
# └─ resume/
#    ├─ services.py
#    └─ ...
# 将项目根目录（my_site的父目录）添加到Python路径
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

# 设置Django配置模块路径，替换成你实际的项目settings路径
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'my_site.settings')

# 初始化Django
django.setup()

# 之后即可正常导入模型
from resume.models import PersonalData

2. 验证项目结构与路径 #

• 确认my_site是包含settings.py、urls.py的项目根目录
• 执行services.py时，确保工作目录为项目根目录，或者通过sys.path正确添加路径（可打印print(sys.path)确认）

3. 推荐的业务逻辑调用方式 #

尽量避免单独运行services.py，建议通过Django上下文调用：

• 在视图、序列化器中调用services.py的函数
• 创建自定义Django管理命令执行业务逻辑
• 在Django Shell中测试：运行python manage.py shell后，导入from resume.services import xxx验证

4. 检查环境变量设置 #

如果通过命令行设置环境变量，确保路径正确：

• Windows cmd：set DJANGO_SETTINGS_MODULE=my_site.settings
• Linux/macOS：export DJANGO_SETTINGS_MODULE=my_site.settings
  设置后先通过python manage.py shell测试模型导入是否正常，再验证services.py

常见排查点 #

• 若仍提示ModuleNotFoundError: No module named 'my_site'，检查sys.path是否包含项目根目录
• 确认INSTALLED_APPS中已添加'resume'，注意是字符串格式且无拼写错误

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