Flask启动报错：无法定位应用及'app'导入失败的排查请求

先搞定「找不到Flask应用」的基础问题 #

• 先确认你打开的命令行工作目录，是不是app.py所在的文件夹。比如你输的命令是PS D:\COVID> python -m flask run，那得确保app.py真的在D:\COVID里，别进错文件夹白忙活。
• 如果文件不在当前目录，要么用cd D:\COVID切到正确路径，要么手动指定FLASK_APP路径：

  # Windows PowerShell下设置环境变量
  $env:FLASK_APP = "D:\COVID\app.py"
  # 然后再启动
  python -m flask run
  

解决「无法导入'app'」的核心问题 #

出现这个错误，90%是app.py的代码结构有问题，按下面检查：

• 必须确保app.py里有标准的Flask实例定义，比如：

  from flask import Flask
  
  # 重点：这个实例必须叫`app`，不然Flask找不到它
  app = Flask(__name__)
  
  @app.route('/')
  def hello():
      return "Hello Flask!"
  
  # 可选：加上这段可以直接用python app.py启动
  if __name__ == '__main__':
      app.run(debug=True)
  

• 要是你的Flask实例不叫app（比如叫my_flask_app），那得改FLASK_APP的设置，告诉Flask找哪个对象：

  $env:FLASK_APP = "app:my_flask_app"
  python -m flask run
  

最后检查环境依赖 #

• 确认当前用的Python环境已经装了Flask：

  pip list | findstr Flask
  

• 没装的话先装：pip install flask
• 如果你用了虚拟环境，一定要先激活虚拟环境再操作，不然会用到系统全局的Python，可能没装Flask或者依赖版本不对。

额外排查技巧 #

• 直接运行app.py测试：python app.py，这样能看到更详细的报错信息，比如语法错误、缺失依赖，比flask run的提示更清楚。
• 检查app.py里有没有拼写错误，比如把Flask写成flask，或者缩进不对，这些小问题也会导致导入失败。

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