Docker环境下Poetry无法安装自定义包mypackage的问题求助

当前问题 #

用Poetry的pyproject.toml和poetry.lock在Docker镜像中安装依赖时，第三方依赖都能成功安装，但自定义包mypackage始终无法安装：

• 添加RUN poetry add mypackage指令会报错：Package 'mypackage' is listed as a dependency of itself
• 不添加该指令，运行时直接报错：ModuleError: No module named 'mypackage'
• 进入容器执行pip list，能看到所有第三方依赖，但找不到mypackage

曾尝试将mypackage/复制到Docker工作目录/scripts/，但问题依旧，怀疑是文件结构或安装流程存在问题。

核心原因 #

你的pyproject.toml已经将当前项目定义为mypackage，但Docker构建时仅复制了配置文件，未将源码文件放置到位，且poetry install默认不会自动安装当前项目包（除非项目源码存在并被正确识别）。

正确解决方案 #

1. 调整Dockerfile的文件复制顺序与内容

必须先把项目的完整文件（包括源码、README.md）复制到容器，再执行poetry install，这样Poetry才能识别并安装本地包。

2. 修改后的完整Dockerfile

FROM python:3.10-slim-bullseye

# 修复原指令语法错误，清理apt缓存减小镜像体积
RUN apt update && apt install -y python3-pip && rm -rf /var/lib/apt/lists/*

RUN pip install "poetry==1.3.1"

RUN mkdir /scripts
WORKDIR /scripts

# 先复制配置文件，利用Docker缓存优化构建速度
COPY poetry.lock pyproject.toml README.md ./
# 复制自定义包源码到容器工作目录
COPY mypackage/ ./mypackage/

# 关闭虚拟环境，安装所有依赖（包括当前自定义包）
RUN poetry config virtualenvs.create false \
  && poetry install --no-dev --no-interaction --no-ansi

# 测试包是否能正常导入
CMD python -c "import mypackage; print('mypackage导入成功！')"

关键说明 #

• 为什么之前复制mypackage没用？：原Dockerfile中poetry install执行在复制mypackage之前，顺序错误！必须确保所有项目文件（源码、配置、说明文件）都复制完成后，再执行安装命令。
• 为什么poetry add会报错？：pyproject.toml中name字段已经是mypackage，再执行poetry add会造成循环依赖，完全不需要这条指令。
• 优化点：先复制配置文件可以利用Docker缓存，避免每次修改源码都重新安装依赖；修复了原apt install的语法错误，同时清理apt缓存减少镜像大小。

额外建议 #

创建.dockerignore文件，排除不需要复制到容器的冗余文件，示例内容：

__pycache__/
*.pyc
*.pyo
.env
.git/
.gitignore
poetry.toml

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