Docker构建Python+Poetry镜像时无法生成poetry.lock与requirements.txt

问题描述 #

构建Python+Poetry镜像时，Dockerfile里执行poetry install后，运行poetry lock --no-update和poetry export命令，始终没法在项目根目录生成poetry.lock和requirements.txt文件。但镜像构建完成后，进入容器手动执行完全相同的命令，却能正常生成目标文件。

用户提供的原Dockerfile内容：

WORKDIR /code

RUN pip install "poetry==$POETRY_VERSION"
RUN poetry config virtualenvs.create false

COPY pyproject.toml poetry.lock* /code/

RUN poetry install --no-root
RUN poetry lock --no-update
RUN poetry export --format=requirements.txt > requirements.txt

COPY . /code/

手动执行时的成功输出：

$ poetry lock --no-update
Skipping virtualenv creation, as specified in config file.
Updating dependencies
Resolving dependencies... (0.2s)

Writing lock file

问题根源 #

核心问题是Docker分层构建的覆盖机制：RUN命令生成的poetry.lock和requirements.txt会被后续的COPY . /code/命令覆盖。因为COPY . /code/是把本地主机的项目目录内容完整复制到容器的/code目录，如果本地没有这两个生成的文件，容器里之前生成的文件就会被清空覆盖。

解决方案 #

方案1：调整命令顺序，避免覆盖 #

把COPY . /code/移到所有RUN命令之前，确保生成文件的步骤在完整项目文件复制之后执行，这样生成的文件不会被覆盖：

WORKDIR /code

RUN pip install "poetry==$POETRY_VERSION"
RUN poetry config virtualenvs.create false

# 先复制所有项目文件到容器
COPY . /code/

# 基于完整项目生成锁文件和requirements.txt
RUN poetry install --no-root
RUN poetry lock --no-update
RUN poetry export --format=requirements.txt > requirements.txt

方案2：分阶段构建（推荐） #

通过分阶段构建，把依赖安装和文件生成的过程放在单独的构建镜像中，再将需要的文件复制到最终镜像，既避免文件被覆盖，还能减少最终镜像的体积：

# 第一阶段：构建依赖与生成文件
FROM python:3.11-slim as builder

WORKDIR /code

ENV POETRY_VERSION=1.6.1
RUN pip install "poetry==$POETRY_VERSION"
RUN poetry config virtualenvs.create false

COPY pyproject.toml poetry.lock* /code/

RUN poetry install --no-root
RUN poetry lock --no-update
RUN poetry export --format=requirements.txt > requirements.txt

# 第二阶段：最终运行镜像
FROM python:3.11-slim

WORKDIR /code

# 从构建阶段复制生成的文件和已安装的依赖
COPY --from=builder /code/poetry.lock /code/requirements.txt /code/
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages

# 复制项目业务代码
COPY . /code/

补充提示 #

• 如果本地原本没有poetry.lock，poetry lock --no-update会自动基于pyproject.toml生成新的锁文件；如果本地已有锁文件，该命令会验证依赖的一致性。
• 部分旧版本Poetry执行export命令时需要添加--without-hashes参数，命令变为：poetry export --format=requirements.txt --without-hashes > requirements.txt

内容的提问来源于stack exchange，提问作者José Victor