Docker中Python无法识别自定义project模块的问题求助

核心原因 #

本地PyCharm会自动将项目根目录（project/）加入Python的模块搜索路径（sys.path），因此能识别project模块。但在Docker中直接运行python main.py时，Python仅会把当前工作目录（/project）加入搜索路径，此时/project下的文件被视为顶级模块内容，而非project模块的子文件，所以找不到project这个模块。

可行解决方案（任选其一即可） #

方案1：修改导入语句

直接调整main.py中的导入逻辑，因为logger.py和main.py处于同一目录，可改为：

# 直接导入
from logger import log
# 或使用相对导入（更符合模块结构语义）
from .logger import log

此方案无需修改Dockerfile，操作最简单。

方案2：设置PYTHONPATH环境变量

修改Dockerfile，将/project的上级目录（即/）加入Python模块搜索路径：

# 在原有Dockerfile中添加环境变量设置，替换原CMD
ENV PYTHONPATH=/
CMD ["python", "main.py"]

这样Python会将/下的project目录识别为合法模块。

方案3：以模块方式运行main.py

调整Dockerfile的工作目录，并使用-m参数以模块形式启动：

# 将工作目录切换到/project的上级目录
WORKDIR /
# 以project模块的main子模块形式运行
CMD ["python", "-m", "project.main"]

此方案更符合Python模块规范，适合需要严格遵循模块结构的场景。

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