Back4app部署Flask+Gunicorn失败：提示No module named 'app'

问题根源 #

容器日志中的ModuleNotFoundError: No module named 'app'，本质是Gunicorn启动指令app:app的匹配条件未被满足：

• 第一个app指Python模块（即app.py文件）
• 第二个app指该模块内定义的Flask实例对象

当前配置下，Gunicorn期望在/app目录找到app.py，且文件内存在app = Flask(__name__)这样的实例定义，但你的代码结构未符合该要求。

解决方案 #

方案1：调整代码文件与实例命名

确保你的Flask代码文件名为app.py，且文件内明确创建名为app的Flask实例，完整代码示例：

from flask import Flask
app = Flask(__name__)

# 在此添加你的路由、业务逻辑代码

if __name__ == "__main__":
    app.run(host='0.0.0.0', port=8080)

保持原Dockerfile的CMD指令不变即可。

若你的Flask代码文件名为其他（比如main.py），则修改Dockerfile的CMD指令，将模块名替换为你的文件名：

CMD ["gunicorn", "-b", "0.0.0.0:8080", "main:app"]

方案2：针对包结构项目调整入口

如果你的项目是带__init__.py的Python包结构，可创建wsgi.py作为统一入口：

1. 在项目根目录创建wsgi.py：

# 假设Flask实例定义在myapp/__init__.py中
from myapp import app

if __name__ == "__main__":
    app.run()

2. 修改Dockerfile的CMD指令：

CMD ["gunicorn", "-b", "0.0.0.0:8080", "wsgi:app"]

方案3：验证镜像内文件结构

构建镜像后，可临时启动容器检查文件路径是否正确：

docker run --rm -it <你的镜像名称> bash
# 查看/app目录下的文件
ls /app

确认Flask代码文件（如app.py）存在于/app目录，避免因COPY . .指令导致的路径错位。

验证修改 #

修改完成后重新构建镜像并部署，容器日志应不再出现ModuleNotFoundError，Gunicorn Worker进程可正常启动，容器能进入健康状态。

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