Docker卷文件访问异常：requirements.txt安装失败原因排查

核心结论 #

你遇到的问题本质是Docker镜像构建阶段和容器运行阶段是完全独立的两个流程，二者的文件系统互不干扰，这也是COPY命令必须存在的原因。

1. 为什么构建时找不到requirements.txt？ #

docker-compose.yml里的volumes挂载规则只在容器运行时生效，构建镜像的过程（执行Dockerfile里的RUN、COPY等指令）完全看不到本地挂载的目录内容：

• 构建阶段：Docker基于Dockerfile一步步构建镜像，此时还没有启动容器，./flask_app:/app这个挂载逻辑还没执行，镜像内的/app目录是空的（仅通过WORKDIR /app创建了空目录），所以RUN pip install -r requirements.txt会报错找不到文件。
• 运行阶段：容器启动后，挂载规则生效，本地的flask_app目录会覆盖容器内的/app目录，这就是你运行容器后能看到requirements.txt的原因——但这个文件来自本地挂载，不是镜像本身的内容。

2. COPY requirements.txt /app/的作用是什么？ #

COPY是镜像构建阶段的指令，它的作用是把构建上下文（这里就是你的flask_app本地目录）里的文件复制到镜像的文件系统中：

• 执行这条指令后，镜像的/app目录里就有了requirements.txt，后续的RUN pip install就能在构建阶段找到并读取这个文件，完成依赖安装。
• 注意：COPY和容器内的cp命令完全不是一回事——cp是容器运行时在容器内部复制文件，而COPY是构建镜像时从本地往镜像里复制文件，和容器运行阶段无关。

3. 为什么不复制其他文件也能运行？ #

因为你在docker-compose.yml里挂载了本地flask_app到容器/app，容器运行时会用本地的代码文件覆盖镜像内/app的内容。镜像里只需要保留安装好的依赖即可，代码文件由本地挂载提供，这是开发阶段常用的热加载方案，但生产环境不建议这么做（应该把代码也COPY到镜像里，保证镜像的独立性）。

补充验证方法 #

如果想确认构建阶段和运行阶段的差异，可以：

• 移除COPY命令构建镜像，然后直接运行这个镜像（不挂载volumes），你会发现容器内的/app目录是空的；
• 保留COPY命令构建镜像，不挂载volumes运行，此时/app里只有requirements.txt和安装的依赖，没有你的代码文件，容器会启动失败。

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