Docker容器运行Python程序出现ModuleNotFoundError问题求助

问题原因 #

本地运行时，你执行脚本的目录（即包含app文件夹的父目录）会被Python自动加入*sys.path*（Python查找模块的路径列表），所以能识别app作为顶层模块。但在Docker里，当你用python3 ./app/run.py直接启动脚本时，Python只会把run.py所在的/src/app目录加入*sys.path*，而app模块的父目录/src不在这个列表里，自然找不到app模块。

解决方法 #

方法1：用模块方式启动脚本（推荐）

修改Dockerfile里的CMD指令，改用Python的模块运行方式：

CMD ["python3", "-m", "app.run"]

这种方式会让Python把当前工作目录（/src）加入*sys.path*，此时app作为/src下的顶层模块就能被正常识别，from app.module import Class的导入方式可以保留。

方法2：设置PYTHONPATH环境变量

在Dockerfile中添加环境变量，把/src加入Python的模块查找路径：

FROM python:3.8

WORKDIR /src 

COPY requirements.txt ./

RUN pip install -r requirements.txt

COPY . .

ENV PYTHONPATH=/src  # 添加这一行

CMD ["python3", "./app/run.py"]

设置后，Python会自动在/src下查找模块，不管用哪种方式启动脚本，app模块都能被找到。

方法3：在run.py中手动添加路径（不推荐）

如果不想修改Dockerfile，可以在run.py开头添加代码，把/src目录加入*sys.path*：

import sys
import os
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

from app.module import Class
# 后续代码...

这种方式虽然能解决问题，但硬编码路径不够灵活，不推荐作为长期方案。

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