Monorepo项目构建Docker镜像时npm install的postinstall执行失败

错误根源 #

报错里的??=是ES2021新增的空值赋值运算符，该语法需要Node.js 15.0.0及以上版本支持。你使用的基础镜像registry-gitlab.com/infrastructure/base-images/node:pipeline中的Node.js版本低于15，导致nx@17.0.2的postinstall脚本执行时触发语法错误。

解决步骤 #

• 确认基础镜像的Node版本：在Dockerfile中临时添加一行命令，查看当前镜像的Node版本：

  RUN node -v
  

  构建镜像时就能看到具体版本，验证是否低于15。

• 更换支持高版本Node的基础镜像：
  如果你可以使用官方镜像，直接替换为LTS版本（比如Node.js 18，稳定且支持ES2021）：

  FROM node:18-alpine
  

  若必须使用公司内部的镜像，联系运维团队获取对应Node.js 15+版本的镜像tag（比如registry-gitlab.com/infrastructure/base-images/node:pipeline-node18，实际以内部镜像为准）。

• 调整Dockerfile（可选优化）：
  针对Monorepo场景，确保复制所有子包的package.json以利用Docker缓存，避免每次构建都重新安装依赖：

  WORKDIR /usr/src/app
  
  # 复制根目录依赖文件
  COPY package.json package-lock.json ./
  # 复制所有子包的package.json（有多个子包可逐个添加）
  COPY packages/app-design/package.json ./packages/app-design/
  
  RUN npm ci
  
  # 复制剩余项目文件
  COPY . .
  
  EXPOSE 8895
  CMD ["npm", "start"]
  

验证 #

修改后重新构建镜像，若Node版本符合要求，npm ci就能正常执行nx的postinstall脚本，不会再出现语法错误。

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