Docker容器运行Flask应用遇Import Error：无法导入'backend'

问题根源 #

1. 代码路径不匹配：Dockerfile里工作目录设为/home/${username}/src，但COPY ./src /home/${username}把src下的backend包直接放到了/home/${username}/，当前工作目录里找不到这个模块。
2. 本地包未安装：setup.py定义了backend的包结构，但容器里没执行安装操作，Python不认这个包。
3. PYTHONPATH配置缺失：就算包存在，所在目录不在Python搜索路径里，照样导不进来。

修复方案 #

方案一：调整路径+安装本地包（推荐） #

修改Dockerfile关键部分：

FROM amazonlinux:2

# 确保已安装Python3.10+、pip等依赖（根据你的基础镜像补充安装步骤）

ENV FLASK_APP=backend
ENV FLASK_RUN_HOST=0.0.0.0

# 把工作目录设为/home/${username}
WORKDIR /home/${username}

# 复制项目文件：src目录、setup.py、.env都放到当前工作目录
COPY ./src ./src
COPY ./setup.py .
COPY ./.env .

# 安装本地backend包（-e是开发模式，方便修改代码；生产环境可以去掉-e直接pip install .）
RUN pip install -e .

EXPOSE 5000
CMD ["flask", "run"]

方案二：保留原工作目录，配置PYTHONPATH #

如果不想改工作目录，按下面调整Dockerfile：

FROM amazonlinux:2

# ... 依赖安装步骤 ...

ENV FLASK_APP=backend
ENV FLASK_RUN_HOST=0.0.0.0
# 把backend所在目录加入PYTHONPATH
ENV PYTHONPATH=/home/${username}

WORKDIR /home/${username}/src

# 复制src到工作目录，确保backend在/home/${username}/src/backend
COPY ./src /home/${username}/src
COPY ./setup.py /home/${username}/setup.py
COPY ./.env /home/${username}/.env

# 安装本地包
RUN pip install -e /home/${username}

EXPOSE 5000
CMD ["flask", "run"]

验证步骤 #

1. 进容器查路径：docker exec -it <容器ID> bash，看看/home/${username}或工作目录里有没有backend文件夹。
2. 测试Python导入：在容器里跑python -c "import backend"，没报错就是包识别成功了。
3. 手动启动Flask：执行flask --app backend run，确认能正常启动服务。

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