Flask 部署后出现 ImportError No module named app 通常是因为 WSGI 服务器找不到入口文件或 Python 环境变量路径配置错误。最推荐的处理方向是检查 WSGI 启动命令中的模块路径是否正确，并确认生产环境已激活对应的虚拟环境。
先说结论：该报错本质是 Python 解释器在 sys.path 中找不到名为 app 的模块，多数情况由启动目录错误或 WSGI 配置路径偏差导致。
- 先确认：生产环境当前工作目录是否与开发环境一致，以及虚拟环境是否激活。
- 先处理：修正 WSGI 服务器（如 Gunicorn/uWSGI）的模块导入路径，确保指向正确的文件对象。
- 再验证：重启服务后查看 stderr 日志，确认不再出现 ImportError 且 HTTP 请求返回正常状态码。
命令速用版
如果使用的是 Gunicorn，检查启动命令中的模块引用格式。以下命令可用于快速诊断路径问题：
# 检查当前 Python 环境识别的搜索路径
python -c "import sys; print('\n'.join(sys.path))"
# 测试能否在当前目录下导入 app 模块
python -c "import app"
# 验证 Gunicorn 绑定路径（假设入口为 app.py 中的 app 对象）
gunicorn `--bind` 0.0.0.0:8000 app:app `--preload`为什么会这样
Python 导入机制依赖 sys.path 列表查找模块，部署环境与开发环境的目录结构或环境变量差异会导致查找失败。
开发时通常在项目根目录运行 flask run，Python 自动将当前目录加入 sys.path。部署时 WSGI 服务器可能以不同用户或目录启动，若未显式设置 PYTHONPATH 或未进入正确目录，解释器无法定位 app.py 文件。此外，虚拟环境未激活会导致依赖包缺失，进而引发导入链断裂。
分步处理
按以下顺序排查，每步完成后尝试重启服务观察日志变化。
1. 确认文件结构与入口名称
检查项目根目录下是否存在 app.py 文件，且文件中定义了 Flask 实例对象（通常名为 app）。
ls -l app.py
grep "^app =" app.py如果文件名为 main.py 或对象名为 application，需调整 WSGI 配置为 main:application。
2. 检查 WSGI 服务器配置
Gunicorn 或 uWSGI 配置文件中指定的模块路径必须相对于 PYTHONPATH 正确。
# Gunicorn 示例配置
# 错误写法：缺少路径或文件名不对
# 正确写法：包名。模块名：对象名
gunicorn myproject.app:app如果 app.py 在子目录中，确保该目录包含__init__.py 成为包，或在启动命令前 export PYTHONPATH。
3. 验证虚拟环境状态
确认生产环境使用的 Python 解释器路径与安装依赖的环境一致。
which python
pip list | grep Flask若路径指向系统默认 Python 而非虚拟环境，需在服务启动脚本中 source 激活虚拟环境。
怎么验证是否生效
服务重启后，通过日志和 HTTP 请求双重验证。
- 日志检查：查看 systemd 或 supervisor 管理的 stderr 日志，确认无 ImportError traceback。
- 请求测试：使用 curl 访问健康检查接口，期望返回 200 OK。
curl -I http://127.0.0.1:8000/常见坑
- 文件名冲突：避免将脚本命名为 flask.py 或 email.py，这会屏蔽标准库模块导致导入错误。
- 相对导入失效：部署环境下相对导入（from . import app）可能失败，建议改用绝对导入。
- 权限问题：运行 WSGI 服务器的用户可能无权读取项目目录，需检查文件权限 chmod。
常见问题
为什么本地运行正常，部署后报错？
因为本地运行通常自动包含当前目录到 sys.path，而部署服务可能从不同目录启动。
修改代码后需要重启服务吗？
生产环境通常关闭了热重载，修改代码后必须重启 WSGI 进程才能生效。
可以使用绝对路径导入吗？
可以，但建议将项目目录加入 PYTHONPATH 环境变量，而不是硬编码绝对路径。
参考来源
- Flask Official Documentation, Deployment Options
- Gunicorn Documentation, Run Configuration