返回 Bug 清单
BUG-0126project-09中已修复python-import-order

模块导入顺序导致 ImportError

发现:2026-09-30验证:2026-10-27置信度:85%

症状

([cursor_202606072236.md:690](file://d:/chemindra/cursor_202606072236.md#L690)): ``` ImportError: cannot import name 'ProjectMember' from 'app.models.project' (D:\chemindra\apps\server\app\models\project.py) ``` 在阶段 2 开发(项目与分子库 CRUD)期间,`uvicorn --reload` 热重载后出现。

根因

`models/__init__.py` 中 `from app.models.project import Project, ProjectMember` 被执行时,`project.py` 中的 `ProjectMember` 类在文件中的定义位置落后于导入点(或因热重载的竞争条件在类定义前就被导入)。

修复方案

调整 `project.py` 中 `ProjectMember` 类定义位置,确保在 `__init__.py` 导入前类已定义。同时在热重载后 `Ctrl+C` 停止并重新启动即可临时解决。

修复命令

调整 `project.py` 中 `ProjectMember` 类定义位置,确保在 `__init__.py` 导入前类已定义。同时在热重载后 `Ctrl+C` 停止并重新启动即可临时解决。

错误签名

ImportError: cannot import name 'ProjectMember' from 'app.models.project' (D:\chemindra\apps\server\app\models\project.py)

技术信息

来源项目

project-09

涉及文件

app/models/__init__.py, app/models/project.py

标签

python-import-order, project-09