如何在Nx Monorepo中Docker化NestJS应用？解决nx命令未找到问题

问题根源 #

出现nx backend:serve not found报错主要是两个原因：

1. 全局安装的nx在Alpine镜像的PATH中无法被yarn正常识别，而且Monorepo项目本身已经把nx作为本地依赖，完全没必要全局安装。
2. 只复制了package*.json，漏掉了nx识别项目必需的配置文件（比如nx.json、workspace.json）以及项目源码，导致nx找不到backend这个项目。

修正后的开发环境Dockerfile #

FROM node:20.9.0-alpine3.18

WORKDIR /src

# 复制整个项目文件（配合.dockerignore过滤无用内容）
COPY . .

# 安装全部依赖（开发模式需要devDependencies）
RUN yarn install --frozen-lockfile

EXPOSE 3000

# 直接调用本地nx，yarn会自动找到node_modules里的nx
CMD ["yarn", "nx", "serve", "backend"]

配套优化：添加.dockerignore #

创建.dockerignore文件减少镜像体积，避免复制冗余文件：

node_modules
dist
.git
.github
.nx
.vscode

生产环境Dockerfile（更优方案） #

如果是部署生产环境，建议先构建产物再运行，镜像体积会小很多：

# 构建阶段
FROM node:20.9.0-alpine3.18 AS builder

WORKDIR /src
COPY . .
RUN yarn install --frozen-lockfile
# 构建backend项目的生产产物
RUN yarn nx build backend --prod

# 生产运行阶段
FROM node:20.9.0-alpine3.18

WORKDIR /app
# 复制构建好的产物
COPY --from=builder /src/dist/apps/backend .
# 只安装生产依赖
COPY package*.json ./
RUN yarn install --production --frozen-lockfile

EXPOSE 3000
# 运行生产产物
CMD ["node", "main.js"]

关键注意点 #

• 别全局装nx，直接用项目本地的nx依赖，yarn会自动处理路径问题。
• 必须复制nx的配置文件和项目源码，不然nx找不到backend项目。
• 开发模式要装全量依赖，生产模式只保留生产依赖就行。

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