Docker镜像迁移后Flask应用无法导入'app'问题求助

问题描述 #

本地环境通过docker-compose up --build可正常运行Flask应用，但将镜像导出为image.tar并在其他环境加载后，使用相同docker-compose.yml启动时，抛出Error: cannot import "app"错误。

环境对比 #

• 正常运行环境：包含Dockerfile、docker-compose.yml、src/app.py
• 异常运行环境：包含image.tar（加载后的镜像）、docker-compose.yml

错误原因分析 #

1. docker-compose配置冲突：
   原配置中build: .会触发重新构建，而非使用已加载的镜像；同时volumes: - .:/app将本地空目录挂载到容器内的/app，直接覆盖了镜像中已存在的代码文件，导致容器内缺少src/app.py。

2. app.py代码缺失核心定义：
   提供的app.py未创建Flask应用实例app = Flask(__name__)，这是Flask命令行工具识别应用的核心；同时入口判断条件错误（__app__应为__main__）。

3. Dockerfile构建逻辑不合理：
   COPY顺序未利用Docker缓存，且重复复制requirements.txt，但这不是直接触发报错的原因。

解决方案 #

1. 调整docker-compose.yml配置 #

当使用已加载的镜像时，需禁用构建逻辑并移除覆盖代码的挂载卷：

version: "3"
services:
  app:
    restart: unless-stopped
    image: your-image-name  # 替换为docker load后显示的镜像名称
    ports:
      - "5005:5005"
    expose:
      - 5005

2. 修复app.py代码 #

补充Flask实例定义并修正入口判断：

from flask import Flask

# 必须定义Flask应用核心实例
app = Flask(__name__)

# 可添加业务路由示例
@app.route('/')
def index():
    return "Flask App Running!"

# 本地直接运行时的启动逻辑
if __name__ == "__main__":
    app.run(port=5005, debug=True, host="0.0.0.0")

3. 优化Dockerfile（可选，提升构建效率） #

调整COPY顺序以利用Docker缓存，避免代码修改时重复安装依赖：

WORKDIR /app

# 先复制依赖文件并安装，缓存依赖层
COPY requirements.txt .
RUN pip install -r requirements.txt

# 再复制全部代码文件
COPY . .

WORKDIR /app/src

ENV FLASK_APP="app.py"
EXPOSE 5005
CMD python -u -m flask run --host=0.0.0.0

验证步骤 #

1. 在原环境重新构建镜像：docker-compose build
2. 导出镜像：docker save -o image.tar your-image-name
3. 在目标环境加载镜像：docker load -i image.tar
4. 使用修改后的docker-compose.yml启动：docker-compose up

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