Docker执行npm start报错sh: webpack: not found问题排查

• 未配置.dockerignore排除本地node_modules目录：执行COPY app/ /app/步骤时，会将宿主机本地的node_modules文件夹直接复制进镜像，覆盖前一步从dependencies阶段复制的、在容器Alpine Linux环境中安装好的依赖。本地依赖是适配宿主机系统（Windows/macOS）的，要么缺包要么二进制文件不兼容，直接导致webpack命令无法识别。
• 依赖安装逻辑存在环境适配问题：如果webpack是声明在package.json的devDependencies字段下，构建过程中若存在NODE_ENV=production的环境变量，npm install会默认跳过所有开发依赖的安装，不会部署webpack。
• 多余的判断逻辑无效：Docker多阶段构建的每个阶段都是全新的干净文件系统，dependencies阶段初始的/app目录为空，写的if [ ! -d /app/node_modules ]判断没有实际作用，不会带来任何缓存优化效果。

1. 在Dockerfile同级目录新建.dockerignore文件，写入以下规则，避免将本地无关文件复制进镜像：

app/node_modules
app/.git
app/.DS_Store
app/dist
app/build
npm-debug.log
.env.local

2. 调整Dockerfile逻辑，移除无效判断，明确依赖安装规则，修正后配置如下：

FROM node:18.2.0-alpine as dependencies
WORKDIR /app

# 仅复制依赖声明文件，充分利用Docker构建缓存
COPY ./app/package.json ./app/package-lock.json ./
# 安装全量依赖，添加--no-audit --no-fund参数提升安装速度
RUN npm install --no-audit --no-fund


FROM node:18.2.0-alpine as build
WORKDIR /app
# 先复制上一阶段安装好的依赖
COPY --from=dependencies /app/node_modules ./node_modules
# 复制项目代码，受.dockerignore规则约束不会覆盖node_modules
COPY ./app/ ./

# 生产部署场景建议替换为打包命令，后续用nginx等静态服务托管构建产物
# RUN npm run build
CMD ["npm", "start"]

3. 若做生产环境部署，不要直接用npm start（通常对应webpack-dev-server开发服务），应该在build阶段执行npm run build生成静态资源，最终镜像仅保留构建产物和静态服务运行环境，大幅缩减镜像体积同时避免开发依赖带来的安全风险。

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