Docker容器内无法找到datapipeline模块，本地运行正常求助

本地运行时可正常访问生成的proto文件，但Docker容器启动时抛出以下错误：

Exception has occurred: ModuleNotFoundError
No module named 'datapipeline.datapipeline'
  File "/app/services/ingest/ingest/processor.py", line 9, in <module>
    import datapipeline.ingest

相关配置及文件信息：

• Dockerfile：

# syntax=docker/dockerfile:1

FROM python:3.9

WORKDIR /app

RUN pip3 install poetry

ADD ../services/ingest/ ./services/ingest/
ADD ../protos/datapipeline/ ./protos/datapipeline/

WORKDIR /app/services/ingest
RUN poetry install

CMD [ "poetry", "run", "python", "ingest/processor.py"]

• services/ingest/pyproject.toml依赖配置：

datapipeline = {path = "../../protos/datapipeline"}

• processor.py导入语句：

import datapipeline.ingest

已将services/ingest和protos/datapipeline按本地层级复制到容器/app目录下。

解决方案 #

1. 确保目录具备Python包标识 #

检查protos/datapipeline目录下是否存在__init__.py文件（空文件即可），让Python识别该目录为可导入的包。本地可能已存在该文件，但需确认Docker复制时未遗漏。

同时建议用COPY替代ADD（ADD会自动解压压缩包，场景更特殊），确保完整复制目录内容：

# syntax=docker/dockerfile:1

FROM python:3.9

WORKDIR /app

RUN pip3 install poetry

# 复制完整目录，包含子文件和隐藏文件
COPY ../services/ingest/ ./services/ingest/
COPY ../protos/datapipeline/ ./protos/datapipeline/

WORKDIR /app/services/ingest
# 加上--no-root避免误安装当前项目根目录
RUN poetry install --no-root

CMD [ "poetry", "run", "python", "ingest/processor.py"]

2. 修正Poetry依赖配置 #

在pyproject.toml中添加develop = true，确保以开发模式安装路径依赖，让Python能正确识别包路径：

[tool.poetry.dependencies]
python = "^3.9"
datapipeline = {path = "../../protos/datapipeline", develop = true}

3. 手动添加Python路径 #

如果上述方法无效，可在processor.py开头强制添加protos目录到Python路径：

import sys
from pathlib import Path

# 从当前文件向上回溯到protos目录
protos_path = str(Path(__file__).parent.parent.parent / "protos")
sys.path.append(protos_path)

import datapipeline.ingest

4. 验证容器内文件结构 #

进入容器内部确认文件结构与本地一致：

# 进入运行中的容器
docker exec -it <容器ID> bash

# 查看目录结构
ls -la /app/
ls -la /app/protos/datapipeline/
ls -la /app/services/ingest/

需确保protos/datapipeline下存在生成的proto Python文件（如ingest_pb2.py、ingest_pb2_grpc.py）及__init__.py。

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