Flask项目启动报错：无法找到'app'模块中的应用或工厂

这个错误的核心是Flask无法在指定的app模块中找到可用的应用实例或工厂函数，下面是具体的排查和解决步骤：

1. 确认项目中app模块的结构 #

先检查项目根目录的文件结构：

• 如果你有app.py文件：打开它，确认里面存在类似app = Flask(__name__)的代码（这是Flask应用的核心实例）。
• 如果你有app文件夹：进入该文件夹，确认存在__init__.py文件，并且文件内定义了Flask应用实例（比如app = Flask(__name__)）或者工厂函数（比如def create_app(): return Flask(__name__)）。

2. 修正FLASK_APP环境变量的配置 #

根据你的app模块实际情况调整run.sh中的配置：

• 如果app/__init__.py或app.py中的应用实例名为app：
  保持export FLASK_APP=app即可，但要确保执行run.sh时处于项目根目录。
• 如果应用实例名不是app（比如叫application）：
  修改为export FLASK_APP=app:application（冒号后面是实例的名称）。
• 如果使用工厂函数创建应用（比如函数名为create_app）：
  修改为export FLASK_APP=app:create_app。

3. 直接验证配置是否有效 #

在激活虚拟环境后，跳过run.sh直接执行以下命令测试：

flask --app app run --debug

如果能正常启动，说明run.sh本身没有问题；如果还是报错，根据终端输出的具体错误信息（比如找不到模块、找不到实例）进一步排查。

也可以通过Python命令直接验证模块导入：

# 执行此命令，如果能输出Flask实例信息则模块正常
python -c "from app import app; print(app)"

额外注意事项 #

• 确保虚拟环境已经正确激活，并且所有依赖（requirements.txt中的包）都已安装完毕。
• 检查项目根目录下是否有拼写错误，比如app文件夹是否写成App（Python模块名区分大小写）。

内容的提问来源于stack exchange，提问作者Salvatore D'angelo