使用flask run命令触发无详情ImportError的问题求助

第一步：先获取完整的错误栈 #

Flask默认的启动报错隐藏了导入错误的细节，你可以直接执行以下命令查看完整报错信息：

# 先进入pipenv虚拟环境
pipenv shell
# 手动导入你配置的FLASK_APP对应的模块，查看具体错误
python -c "import <App Name>"

如果你的create_app实际定义在<App Name>_api/__init__.py中，也可以直接执行：

python -c "from <App Name>_api import create_app"

执行后会输出完整的导入错误栈，直接定位到触发问题的文件和代码行。

常见问题及解决方案 #

按照你的项目结构，90%以上的概率是FLASK_APP配置路径不匹配导致的：

• 你当前.flaskenv中配置的FLASK_APP=<App Name>:create_app()，是告诉Flask去根目录下的<App Name>.py文件中找create_app函数，但你的create_app实际定义在<App Name>_api包的__init__.py中，路径不匹配自然会导入失败。
• 解决方案有两种：
  1. 修改.flaskenv中的FLASK_APP配置为：

  FLASK_APP=<App Name>_api:create_app()
  

  2. 如果你确实需要从根目录的<App Name>.py暴露入口，需要在<App Name>.py中添加导入逻辑：

  from <App Name>_api import create_app
  

其他可能的问题排查点：

• 检查是否所有依赖都已安装：执行pipenv install确认Pipfile中所有依赖都安装到当前虚拟环境
• 排查循环导入问题：检查<App Name>_api/__init__.py中是否存在循环导入，比如在初始化文件中导入了models、resources，而这些模块又反过来导入了初始化文件中的变量
• 检查是否存在命名冲突：确认你的包名、文件名没有和Python内置模块或已安装的第三方库重名

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