NX CLI Docker-Compose问题：缺失linux-x64平台依赖

问题场景 #

使用NestJS开发Wolverine服务，通过docker-compose up wolverine启动时，镜像和容器构建完成后触发NX Missing Platform Dependency错误，提示The Nx CLI could not find or load the native binary for your supported platform (linux-x64)，当前使用Nx v17.2.8版本。已尝试删除node_modules重新安装、更新Visual C++ Redistributable、确认本地和Docker环境的依赖包完整性，但问题未解决。

问题根源 #

当前Dockerfile的构建阶段使用node:18.16.1-alpine镜像，Alpine Linux基于musl libc，而Nx v17的原生二进制文件默认针对glibc编译，二者兼容性存在问题；同时运行阶段重新执行npm ci --ignore-scripts可能导致下载的依赖与构建阶段平台不匹配。

解决方案 #

方案1：切换构建镜像为Debian基础版（推荐） #

修改Dockerfile，将构建阶段的基础镜像更换为Debian-based的Node镜像（默认glibc环境），并直接复制构建阶段的node_modules到运行阶段，确保依赖一致性：

FROM node:18.16.1 as builder

WORKDIR /home/node

COPY package*.json /home/node/

# 显式指定平台架构，强制下载linux-x64的Nx原生二进制
RUN npm install --platform=linux --arch=x64

COPY . /home/node/

RUN npm run build wolverine

FROM node:18.16.1-alpine as wolverine

WORKDIR /home/app

COPY --from=builder /home/node/dist/apps/wolverine/package*.json /home/app/

# 直接从构建阶段复制完整node_modules，避免重新安装导致的平台不匹配
COPY --from=builder /home/node/node_modules /home/app/node_modules

COPY --from=builder /home/node/dist/ /home/app/dist/

RUN apk --no-cache add curl

CMD ["node", "dist/apps/wolverine/main.js"]

方案2：在Alpine镜像中添加glibc兼容层 #

如果必须使用Alpine镜像，需在构建阶段安装glibc兼容组件，并指定平台参数安装依赖：

FROM node:18.16.1-alpine as builder

WORKDIR /home/node

# 安装glibc兼容层，解决Nx二进制依赖问题
RUN apk add --no-cache libc6-compat

COPY package*.json /home/node/

RUN npm install --platform=linux --arch=x64

COPY . /home/node/

RUN npm run build wolverine

FROM node:18.16.1-alpine as wolverine

WORKDIR /home/app

COPY --from=builder /home/node/dist/apps/wolverine/package*.json /home/app/

COPY --from=builder /home/node/node_modules /home/app/node_modules

COPY --from=builder /home/node/dist/ /home/app/dist/

RUN apk --no-cache add curl libc6-compat

CMD ["node", "dist/apps/wolverine/main.js"]

验证 #

修改Dockerfile后，重新执行docker-compose up wolverine，服务应能正常启动并监听配置端口，不再出现Nx平台依赖错误。

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