Docker工具容器生成requirements.txt本地文件为空问题排查

我想用Docker的Python 3.12镜像生成适配该版本的requirements.txt，计划步骤是：在容器内安装依赖，将依赖列表冻结到requirements.txt，再通过绑定挂载同步到本地。但本地的requirements.txt始终为空，相关配置如下：

Dockerfile内容：

FROM python:3.12.0-bookworm
WORKDIR /backend
# Install dependencies:
RUN pip3 install --upgrade pip
RUN pip3 install pandas
<install more packages>

ENTRYPOINT [ "python3", "-m", "pip", "freeze", "-r", "requirements.txt"]

docker-compose.yml内容：

version: '3.8'
services:
  python-deps:
    working_dir: /backend
    build:
      context: ./backend
      dockerfile: python.Dockerfile
    volumes:
        - ${PWD}/backend/requirements.txt:/backend/requirements.txt
    tty: true 
    stdin_open: true
    profiles:
      - startup-backend

执行docker-compose run python-deps后，终端能正常输出冻结的依赖列表，但本地requirements.txt依旧为空，换成挂载整个目录后问题仍存在。

你的问题核心出在两个关键错误上：

1. pip freeze -r requirements.txt的用法误解
   这个命令的作用是对比requirements.txt中声明的依赖与容器内已安装的依赖，仅将差异内容输出到终端，而非写入到requirements.txt文件本身。你当前只是把结果打印出来，完全没有往挂载的本地文件里写入内容。

2. 缺少输出重定向操作
   要把冻结结果写入文件，必须在命令中添加重定向符号，将输出导向挂载的文件路径。

修正方案一：修改Dockerfile的ENTRYPOINT #

将ENTRYPOINT替换为以下内容，让pip freeze的结果直接写入绑定挂载的文件：

ENTRYPOINT ["sh", "-c", "pip freeze > /backend/requirements.txt"]

这里去掉-r requirements.txt，因为我们需要的是冻结容器内所有已安装的、适配3.12的依赖，而非对比旧的依赖文件。

修正方案二：本地直接捕获容器输出 #

无需修改现有配置，直接在运行命令时将容器的终端输出重定向到本地文件：

docker-compose run --rm python-deps pip freeze > ./backend/requirements.txt

这种方式更灵活，甚至可以删除docker-compose中的挂载配置，因为不需要容器主动写入本地文件，而是由本地直接捕获输出内容。

补充：基于旧requirements.txt适配3.12的流程 #

如果你的需求是先基于旧的requirements.txt安装兼容3.12的版本，再生成新的依赖文件，正确的Dockerfile应该是这样：

FROM python:3.12.0-bookworm
WORKDIR /backend
# 复制本地旧的requirements.txt到容器内
COPY requirements.txt .
RUN pip3 install --upgrade pip
# 安装依赖（pip会自动处理3.12的兼容版本）
RUN pip3 install -r requirements.txt
# 冻结到新的requirements.txt
ENTRYPOINT ["sh", "-c", "pip freeze > /backend/requirements.txt"]

配合挂载目录的docker-compose配置运行后，本地就能得到适配Python 3.12的requirements.txt。

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