为何Docker容器返回缓存值？NestJS应用Docker部署问题排查

你遇到的问题核心是命名卷app-data挂载覆盖了容器内的/app目录。第一次启动容器时，Docker会把镜像中/app的内容复制到命名卷里，但之后无论怎么重新构建镜像，卷里的旧代码都不会自动被替换——容器启动时会优先使用卷内的内容，而非镜像里的新代码。

方案1：改用绑定挂载（开发环境首选） #

开发环境推荐用本地目录绑定挂载，本地代码修改后能实时同步到容器，彻底避免卷缓存问题。修改compose.yaml中app服务的volumes配置：

services:
  app: 
    # 其他配置保持不变
    volumes:
      - ./:/app/  # 绑定本地项目目录到容器/app
      - /app/node_modules  # 用匿名卷隔离容器的node_modules，避免本地node_modules干扰

同时在项目根目录创建.dockerignore文件，排除不必要的文件以减少镜像构建时间：

node_modules
dist
.git
.env

方案2：清空旧命名卷（保留命名卷的场景） #

如果必须使用命名卷，需要手动删除旧卷，让Docker重新从新镜像同步内容：

1. 停止并删除容器、卷：

   docker compose down -v
   

2. 重新构建并启动：

   docker compose up --build
   

• Dockerfile建议使用指定版本的Node镜像，比如node:20-alpine，避免latest版本的兼容性问题，同时减小镜像体积：

  FROM node:20-alpine
  WORKDIR /app
  COPY package*.json ./
  RUN npm install
  COPY . .
  CMD ["npm", "run", "start:dev"]
  

• 修正compose.yaml中MongoDB的环境变量格式，应该用=而非:：

  environment:
    - MONGO_INITDB_ROOT_USERNAME=root
    - MONGO_INITDB_ROOT_PASSWORD=example
  

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