单元测试跨目录导入报ImportError: Import by filename is not supported
报错核心原因
ImportError: Import by filename is not supported 这个报错不是你写的导入语句语法有问题,本质是Python解释器找不到目标模块所在的路径,把你写的模块名识别成了带后缀的物理文件路径,才抛出的错。
对应项目的触发逻辑
你当前的项目层级是常规Flask应用结构:
项目根目录/ ├── app.py # 存create_app、CURR_USER_KEY的源文件 ├── models.py # 存db、User的源文件 ├── config.py └── tests/ └── test_user_views.py # 运行报错的单元测试文件
如果你直接进到tests/文件夹里执行测试命令,Python会默认把当前所在的tests/目录作为最高优先级的模块搜索路径,既找不到上一级目录里的app、models模块,也会因为路径匹配失败,把导入请求误判成“按文件路径加载”,直接触发报错。
具体解决方法
- 启动测试时永远从项目根目录执行命令,不要cd进tests文件夹再跑脚本。直接在项目根的终端里执行
python -m pytest tests/即可,Python会自动把当前工作目录(也就是项目根)加入模块搜索路径,正常识别你写的from app import create_app这类导入语句。 - 如果必须要在tests目录下运行测试,就在测试文件的所有导入语句最前面,手动把项目根目录加到模块搜索路径里:
import sys from pathlib import Path # 自动定位测试文件的上一级目录(即项目根),插入到搜索路径最前面 sys.path.insert(0, str(Path(__file__).parent.parent)) - 排查错误导入写法:导入语句里绝对不要带
.py后缀(比如写成from app.py import create_app是100%触发这个报错的),更不要把文件的绝对路径直接写到导入语句里(比如from /home/yourname/project/app import create_app),这类写法都会被解释器判定为“按文件名加载”。 - 检查是否有文件冲突:看看tests目录下是不是误生成了重复的
app.py、models.py文件,清理后重启测试进程即可。
内容的提问来源于stack exchange,提问作者rudehlabya
相关产品推荐
相关产品推荐

