Docker中Python脚本无法找到子目录模块问题求助

问题背景 #

项目结构 #

.
├── my_script.Dockerfile
├── README.rst
├── log
│   └── my_script.log
├── pickles
├── requirements.txt
├── requirements_my_script.txt
├── src
│   ├── __init__.py
│   ├── __pycache__
│   ├── main.py
│   ├── modules
│   │   ├── __init__.py
│   │   └── module.py
│   ├── other_scripts
│   │   └── my_script.py
│   └── utils
│       ├── __init__.py
│       ├── __pycache__
│       └── logging_utils.py

初始Dockerfile（版本1） #

# syntax=docker/dockerfile:1

FROM python:3.10-slim-buster
WORKDIR /src
COPY requirements_my_script.txt requirements_my_script.txt
RUN pip3 install -r requirements_my_script.txt
COPY src/. .
CMD ["python3", "other_scripts/my_script.py"]

调整后的Dockerfile（版本2） #

# syntax=docker/dockerfile:1

FROM python:3.10-slim-buster
WORKDIR /app
COPY requirements_my_script.txt requirements_my_script.txt
RUN pip3 install -r requirements_my_script.txt
COPY src/ src/
CMD ["python3", "src/other_scripts/my_script.py"]

核心代码片段 #

my_script.py的导入部分：

import logging

from src.utils.logging_utils import start_logger

错误信息 #

from src.utils.logging_utils import start_logger
ModuleNotFoundError: No module named 'src'

错误原因 #

本地运行正常是因为项目根目录（src的父目录）被自动加入Python的模块搜索路径sys.path，Python能识别src作为顶层包。但Docker容器中运行时：

• 版本1：WORKDIR设为/src，COPY src/. .把src下的文件直接平铺到/src，运行other_scripts/my_script.py时，Python仅将/src/other_scripts加入搜索路径，找不到src模块。
• 版本2：WORKDIR设为/app，src目录在/app/src，运行src/other_scripts/my_script.py时，Python仅将/app/src/other_scripts加入搜索路径，/app不在路径内，无法识别src作为顶层包。

解决方案 #

方法1：修改脚本导入路径（灵活适配） #

在my_script.py开头添加代码，将项目根目录加入sys.path：

import sys
import os

# 获取当前脚本所在目录的上级上级目录（即src的父目录）
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(project_root)

import logging
from src.utils.logging_utils import start_logger

无论脚本在哪个路径运行，都能正确找到src模块。

方法2：以模块方式运行脚本（Docker规范写法） #

修改Dockerfile，用-m参数以模块形式执行脚本：

# syntax=docker/dockerfile:1
FROM python:3.10-slim-buster
WORKDIR /app
COPY requirements_my_script.txt .
RUN pip3 install -r requirements_my_script.txt
COPY src/ ./src/
# 以模块方式运行，Python自动将当前工作目录（/app）加入sys.path
CMD ["python3", "-m", "src.other_scripts.my_script"]

符合Python包运行规范，无需修改脚本代码。

方法3：设置PYTHONPATH环境变量 #

在Dockerfile中指定模块搜索路径：

# syntax=docker/dockerfile:1
FROM python:3.10-slim-buster
WORKDIR /app
COPY requirements_my_script.txt .
RUN pip3 install -r requirements_my_script.txt
COPY src/ ./src/
# 将项目根目录加入PYTHONPATH
ENV PYTHONPATH="/app"
CMD ["python3", "src/other_scripts/my_script.py"]

通过环境变量告知Python模块位置，无需修改脚本。

额外提示 #

logging_utils.py中的日志路径os.path.join(os.path.expanduser('~'), 'project_folder_name', 'log')，在Docker中~对应/root。如果需要持久化日志，建议将路径改为容器内固定目录（如/app/log），再通过Docker挂载卷关联到宿主机，避免日志丢失。

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