Dockerfile执行RUN yarn后node_modules未安装，此前正常运行求助

可能的问题原因 #

• Docker构建缓存未失效：依赖文件更新后，缓存的安装步骤未重新执行
• 本地node_modules被复制到容器：构建时未排除本地node_modules，覆盖了容器内安装的依赖
• 插件目录构建顺序错误：先复制整个插件目录，再处理依赖，导致依赖文件被覆盖
• Alpine镜像缺少编译依赖：部分native模块需要的编译工具未安装，导致依赖安装失败
• 网络问题：构建时容器无法访问yarn仓库，依赖下载失败

修复步骤 #

1. 清理构建缓存，强制重新安装 #

运行构建命令时跳过缓存，确保依赖重新安装：

docker build --no-cache -t your-image-name .

2. 添加.dockerignore排除不必要文件 #

在项目根目录创建.dockerignore文件，内容如下：

node_modules
.git
logs
.DS_Store

避免本地node_modules、日志等文件被复制到容器中干扰依赖安装。

3. 调整Dockerfile的构建顺序（关键修复） #

原Dockerfile存在复制顺序错误，调整后确保先安装依赖再复制代码，修改后的Dockerfile如下：

FROM node:18-alpine3.18

# 安装native模块编译依赖（如果项目包含需要编译的依赖，如node-sass等）
RUN apk add --no-cache build-base python3

RUN mkdir -p /usr/node/app/logs
RUN chmod -R 777 /usr/node/app
WORKDIR /usr/node/app

# 先复制根目录依赖文件，利用Docker缓存
COPY package*.json yarn.lock ./
RUN yarn install --production=false

# 复制项目代码
COPY . .
RUN yarn postinstall

# 处理插件目录：先复制插件依赖文件，再安装构建
WORKDIR /usr/node/app/src/plugins/organization
COPY src/plugins/organization/package*.json src/plugins/organization/yarn.lock ./
RUN yarn install --production=false
RUN yarn build

# 返回根目录，设置环境变量
WORKDIR /usr/node/app
ENV NODE_ENV production
EXPOSE 1337
CMD ["yarn", "start"]

4. 查看详细构建日志排查错误 #

使用--progress=plain参数查看完整构建日志，定位yarn安装失败的具体原因：

docker build --progress=plain -t your-image-name .

重点查看RUN yarn步骤的输出，确认是否有依赖缺失、网络错误或编译失败的提示。

5. 检查yarn.lock文件 #

确保yarn.lock文件已提交到版本控制，构建时使用锁定的依赖版本，避免因依赖版本变动导致安装失败。

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