如何在Docker构建过程中自动创建并安装requirements.txt文件

错误原因分析 #

你当前的Dockerfile存在两个核心问题：

1. 命令逻辑错误：CMD mkdir /project/dir/是容器启动时才会执行的命令，构建阶段不会创建目录（不过WORKDIR会自动创建不存在的目录，这步其实多余）；而且你在还没复制项目代码、安装任何项目依赖的情况下就执行pip freeze，生成的只是Python基础镜像自带的依赖列表，完全不是你项目需要的。
2. 文件不存在导致构建失败：ADD ./requirements.txt ./requirements.txt是尝试从本地构建上下文（执行docker build的目录）读取这个文件，但你本地并没有维护该文件，因此触发not found错误。

正确实现方案 #

你的核心需求是在Docker构建过程中自动生成requirements.txt，无需手动维护，以下是两种适配不同场景的修正方案：

方案1：基于现代Python依赖配置文件（推荐） #

如果你的项目使用pyproject.toml（搭配Poetry/Pipenv）或setup.py/setup.cfg，可以先复制依赖配置文件，安装依赖后再生成requirements.txt，同时利用Docker缓存优化构建速度：

FROM --platform=arm64 python:3.9-buster

# WORKDIR会自动创建不存在的目录，无需手动mkdir
WORKDIR /project/dir/

ENV PYTHONUNBUFFERED=1

# 先复制依赖配置文件，触发Docker缓存
COPY pyproject.toml poetry.lock* ./  # 若使用Poetry
# 若使用setuptools则替换为：COPY setup.py setup.cfg ./

# 升级pip并安装项目依赖
RUN pip install --upgrade pip
RUN pip install .  # 安装项目及其所有依赖
# 若用Poetry可替换为：RUN pip install poetry && poetry install --no-root

# 在容器内生成requirements.txt
RUN pip freeze > requirements.txt

# 复制剩余项目代码
COPY . .

RUN chmod +x ./run.sh

ENTRYPOINT ["sh", "./run.sh"]

方案2：无依赖配置文件，直接从项目捕获依赖 #

如果你的项目没有单独的依赖配置文件，需要先复制全部代码，安装依赖后再生成requirements.txt：

FROM --platform=arm64 python:3.9-buster

WORKDIR /project/dir/

ENV PYTHONUNBUFFERED=1

RUN pip install --upgrade pip

# 复制全部项目代码
COPY . .

# 安装项目依赖（示例：手动安装或通过setup.py安装）
# 手动安装示例：RUN pip install flask requests
# 或通过setup.py安装：RUN pip install .

# 生成项目实际依赖的requirements.txt
RUN pip freeze > requirements.txt

# 可选：验证依赖安装（重复安装确保一致性）
# RUN pip install -r requirements.txt

RUN chmod +x ./run.sh

ENTRYPOINT ["sh", "./run.sh"]

关键注意事项 #

• 避免提前执行pip freeze：必须在安装完项目所有依赖后再执行pip freeze，这样生成的才是项目实际需要的依赖列表。
• 不要引用本地不存在的文件：既然目标是在容器内生成requirements.txt，就不需要用ADD/COPY从本地引入该文件。
• 利用Docker缓存：先复制依赖配置文件再安装依赖，可避免每次修改代码都重新安装依赖，大幅提升构建效率。

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