修改Dockerfile后用docker-compose运行时变更未生效的问题

问题背景与现象 #

我正在观看Stephen Grider的Docker & Kubernetes教程，在「构建生产级工作流」模块中以React/Node.js项目为例学习相关概念。

初始操作步骤 #

1. 通过Linux命令创建项目：

[root@fedora Desktop]# npm install -g create-react-app
[root@fedora Desktop]# create-react-app frontend

2. 进入frontend目录，创建开发环境的Dockerfile.dev：

FROM node:alpine

WORKDIR '/app'

COPY package.json .
RUN npm install

COPY . .

CMD ["npm", "run", "start"]

3. 创建docker-compose.yml简化运行：

# Our docker-compose.yml
version: '3'
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
    - "3000:3000"
    volumes:
    - /app/node_modules
    - .:/app

执行docker-compose up即可正常启动容器。教程提到可省略Dockerfile.dev中的COPY . .，因为卷映射已将容器内/app目录与主机当前目录关联，仅/app/node_modules使用容器镜像内的文件。

异常测试步骤 #

调整配置后出现不符合预期的现象：

• 删除Dockerfile.dev中的COPY package.json .和RUN npm install，执行docker-compose up --build，未出现预期的依赖缺失错误，但教程称会报错；
• 仅添加回RUN npm install，执行docker-compose up --build，出现预期错误；
• 再次删除RUN npm install，结果与第一步一致；
• 删除docker-compose.yml中volumes下的/app/node_modules，执行docker-compose up --build，出现预期的sh: react-scripts: not found错误；
• 添加回/app/node_modules，配置与第一步完全一致，此时出现了预期的错误。

问题原因分析 #

核心原因是Docker匿名卷的持久化特性，结合镜像缓存共同导致了该现象：

1. 第一次运行包含RUN npm install的镜像时，Docker会自动用镜像中/app/node_modules的内容初始化对应的匿名卷（这是Docker的默认行为：若卷为空，启动容器时会同步镜像内对应目录的内容）；
2. 后续修改Dockerfile.dev删除COPY package.json和RUN npm install并重新构建镜像时，新镜像中没有/app/node_modules，但启动容器时会复用之前已经存在的匿名卷——该卷内仍保留着第一次安装的依赖，因此不会触发错误；
3. 第四步删除/app/node_modules卷配置后，容器启动时不再使用该匿名卷，转而使用主机挂载的当前目录（主机目录未安装依赖），因此触发了预期错误；
4. 第五步重新添加卷配置时，之前的匿名卷已因第四步的操作被移除（或docker-compose创建了新的空卷），此时新镜像无依赖、卷也为空，因此触发了预期错误。

镜像缓存确实会影响构建过程，但本场景中最关键的是匿名卷的持久化缓存，而非镜像层缓存。

解决方案：第一步就触发预期错误 #

要彻底清理所有缓存，确保从零开始测试：

1. 停止并删除所有相关容器及关联卷：

docker-compose down -v

2. 删除之前构建的相关镜像（替换为你的镜像名或ID）：

docker rmi $(docker images | grep frontend-web | awk '{print $3}')

3. 确保主机项目目录下没有残留的node_modules：

rm -rf node_modules

4. 修改Dockerfile.dev，删除COPY package.json .和RUN npm install，执行：

docker-compose up --build

此时容器启动时既没有镜像内的依赖，也没有卷缓存的依赖，会直接触发sh: react-scripts: not found的预期错误。

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