Docker多阶段构建中Nest.js CLI无法找到的问题求助

问题原因 #

你的Dockerfile核心问题在于：

• base阶段提前设置了NODE_ENV=production，执行npm ci时，npm会自动跳过devDependencies下的包
• Nest CLI（@nestjs/cli）默认是作为开发依赖存在于package.json的devDependencies中，因此base阶段的node_modules里根本没有安装这个工具，自然找不到nest命令

解决方案：规范拆分多阶段构建 #

推荐采用分离构建层与运行层的多阶段构建方案：专门新增一个build阶段安装所有依赖（含开发依赖）完成代码构建，生产阶段仅复制构建产物和生产依赖，既解决构建问题，又能最小化生产镜像体积。

修改后的Dockerfile示例：

# 基础镜像：仅安装生产依赖，用于最终生产运行
FROM node:18-slim as base
WORKDIR /app
RUN chown -R node:node /app
USER node
COPY --chown=node:node package*.json ./
# 只安装生产依赖，减少镜像体积
RUN npm ci --omit=dev && npm cache clean --force

# 构建阶段：安装全部依赖（含开发依赖），完成代码编译
FROM node:18-slim as build
WORKDIR /app
RUN chown -R node:node /app
USER node
COPY --chown=node:node package*.json ./
# 安装所有依赖（包括Nest CLI等开发工具）
RUN npm ci && npm cache clean --force
COPY --chown=node:node . .
# 执行Nest.js构建命令
RUN npm run build

# 生产阶段：基于base镜像，仅复制构建产物
FROM base as prod
EXPOSE 3000
# 从build阶段复制编译好的dist目录
COPY --chown=node:node --from=build /app/dist ./dist
# 启动生产服务
CMD ["node", "dist/main.js"]

# 开发阶段（可选，独立于生产构建流程）
FROM node:18-slim as dev
WORKDIR /app
RUN chown -R node:node /app
USER node
COPY --chown=node:node package*.json ./
RUN npm install
COPY --chown=node:node . .
ENV NODE_ENV=development
ENV PATH /app/node_modules/.bin:$PATH
CMD ["npm", "run", "start:dev"]

方案优势 #

1. 构建与运行分离：build阶段专门负责编译代码，拥有完整的开发依赖；prod阶段仅保留运行所需的生产依赖，镜像体积更小、更安全
2. 避免依赖冲突：生产环境不会包含不必要的开发工具，降低潜在风险
3. 流程清晰：各阶段职责明确，便于维护和扩展

临时应急方案（不推荐） #

如果只是临时测试，也可以在base阶段强制安装所有依赖，但会导致生产镜像包含大量开发依赖，体积膨胀：

FROM node:18-slim as base
ENV NODE_ENV=production
WORKDIR /app
RUN chown -R node:node /app
USER node
COPY --chown=node:node package*.json ./
# 强制安装所有依赖（含开发依赖）
RUN npm ci --include=dev && npm cache clean --force
ENV PATH /app/node_modules/.bin:$PATH
COPY --chown=node:node . .

# 后续dev、prod阶段不变...

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