Dockerfile中执行RUN poetry install无法生成poetry.lock求助

问题原因 #

Docker构建阶段执行poetry install --no-root时，确实会在镜像内的/src目录生成poetry.lock，但启动容器时，你通过volumes: - .:/src将本地项目目录挂载到了容器的/src，覆盖了镜像内的所有文件，因此本地看不到生成的poetry.lock。而docker compose run是在挂载本地目录后的容器内执行命令，生成的poetry.lock会直接写入本地挂载目录，所以本地能看到。

解决方案 #

方案1：本地预生成poetry.lock（推荐） #

这是最规范的做法，能保证开发环境与构建环境的依赖版本一致：

• 在本地项目根目录执行：

poetry lock

• 重新构建镜像：

docker compose build

此时Dockerfile的COPY pyproject.toml* poetry.lock* ./会将本地的poetry.lock复制到镜像中，构建时poetry install会基于lock文件安装依赖，避免每次构建重新解析依赖版本。

方案2：调整目录结构避免挂载覆盖依赖文件 #

如果不想在本地生成lock文件，可以分离依赖目录与代码目录，避免挂载覆盖：

1. 修改Dockerfile：

FROM python:3.11

ENV LANG C.UTF-8
ENV TZ Asia/Tokyo
ENV PYTHONUNBUFFERED=1

# 依赖目录与代码目录分离
WORKDIR /app

RUN pip install poetry

COPY pyproject.toml* ./

# 生成lock文件并安装依赖
RUN poetry config virtualenvs.create false && poetry lock && poetry install --no-root

# 代码挂载目录
WORKDIR /app/src

ENTRYPOINT ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--reload"]

2. 修改docker-compose.yml的挂载路径：

services:
  backend:
    # 其他配置不变
    volumes:
      - .:/app/src

构建阶段生成的poetry.lock会保存在/app目录，不会被本地挂载覆盖，本地代码挂载到/app/src不影响依赖文件。

方案3：容器启动时自动生成lock文件（临时方案） #

通过自定义启动脚本，在服务启动前检查并生成lock文件：

1. 在项目根目录创建entrypoint.sh：

#!/bin/bash

if [ ! -f poetry.lock ]; then
    poetry lock
fi

poetry install --no-root

uvicorn api.main:app --host 0.0.0.0 --reload

2. 赋予脚本执行权限：

chmod +x entrypoint.sh

3. 修改Dockerfile的ENTRYPOINT：

# 其他配置不变
ENTRYPOINT ["./entrypoint.sh"]

每次启动容器时，会自动生成poetry.lock到本地挂载目录，并确保依赖安装完成后再启动服务。

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