Docker Compose容器中NestJS项目node_modules依赖未安装问题

问题原因分析 #

你的配置里，Dockerfile确实在构建阶段执行了yarn --frozen-lockfile安装依赖，但启动容器后依赖未正确加载，核心原因有两点：

1. 镜像复用导致依赖未更新
   首次构建test-sangeet-dev镜像后，后续执行docker-compose up时Docker会默认复用已存在的镜像，不会重新构建。如果此时本地的package.json或yarn.lock有修改，镜像内的依赖还是旧版本，和挂载的新版本代码不匹配，就会出现依赖缺失。

2. 匿名卷与本地挂载的交互问题
   你配置了- .:/app将本地目录挂载到容器/app，同时用- /app/node_modules创建匿名卷保留容器内的依赖目录，避免被本地挂载覆盖。但如果首次构建镜像时依赖安装不完整（比如网络问题），或者后续本地依赖配置变更后未重新构建镜像，匿名卷里的旧依赖就无法匹配当前代码需求。

最优解决方案 #

推荐以下几种规范方式，避免手动进入容器执行命令的繁琐：

方案1：强制构建+清理旧卷（最彻底）

每次启动测试环境前，彻底清理旧容器和卷，强制重新构建镜像，确保依赖完全匹配当前代码：

docker-compose -f docker-compose.test.yml down -v
docker-compose -f docker-compose.test.yml up --build

• down -v：停止容器并删除所有关联卷（包括匿名卷），清除旧依赖
• up --build：强制重新构建镜像，重新执行yarn --frozen-lockfile安装最新依赖

方案2：启动时自动检查依赖（适合开发阶段）

修改docker-compose.test.yml中test-app的command，在启动服务前自动检查并安装依赖：

# test-app 服务的 command 替换为
command: sh -c "yarn --frozen-lockfile && yarn start:dev"

这种方式每次启动容器都会先校验依赖，虽然增加少量启动时间，但能保证依赖与当前代码完全一致，适合频繁修改依赖的开发场景。

方案3：优化镜像构建流程（推荐CI/CD环境）

调整Dockerfile，利用分层缓存优化构建速度，同时确保依赖安装的可靠性：

FROM node:18-alpine as dev

RUN apk add --no-cache libc6-compat
RUN apk add git &&\
    git config --global --add safe.directory /app

WORKDIR /app

# 先复制依赖配置文件，利用Docker缓存
COPY --chown=node:node package.json yarn.lock ./
RUN yarn --frozen-lockfile

# 再复制其余代码
COPY --chown=node:node . .

USER node

修改后，只有当package.json或yarn.lock变更时，才会重新执行依赖安装，否则复用缓存层加快构建速度。配合docker-compose up --build使用，能高效保证依赖正确。

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