Docker构建Node项目遇依赖冲突：Node14/16版本均报错求助

问题现象 #

使用Node.js 14基础镜像时的报错 #

npm ERR! code ENOTSUP
npm ERR! notsup Unsupported engine for @nestjsi/class-validator@0.2.1: wanted: {"node":">=16.0.0"} (current: {"node":"14.19.3","npm":"6.14.17"})
npm ERR! notsup Not compatible with your version of node/npm: @nestjsi/class-validator@0.2.1
npm ERR! notsup Not compatible with your version of node/npm: @nestjsi/class-validator@0.2.1
npm ERR! notsup Required: {"node":">=16.0.0"}
npm ERR! notsup Actual:   {"npm":"6.14.17","node":"14.19.3"}

npm ERR! A complete log of this run can be found in:
npm ERR!     /apps/.npm/cache/_logs/2022-07-22T15_16_09_537Z-debug.log

使用Node.js 16基础镜像时的报错 #

npm ERR! Found: rxjs@7.5.6
npm ERR! node_modules/rxjs
npm ERR!   rxjs@"^7.2.0" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer rxjs@"^6.0.0" from @nestjs/common@7.6.18

当前Dockerfile内容 #

FROM abc.xyz.com/abc-xyxa/ab/nodejs:14 As Development

USER root
# set the root's npm configuration to our project's configuration
COPY .npmrc /root/.npmrc


# copy project file
COPY package.json .
# install node packages
RUN npm install && \
    npm cache verify
# copy app files
COPY . .

# Set EDT Time Zone
RUN echo America/New_York | tee /etc/timezone && dpkg-reconfigure --frontend noninteractive tzdata
# application server port
EXPOSE 3000
# default run command
CMD [ "nest", "start" ]

解决方案 #

方案1：统一依赖版本适配Node.js 16 #

因为@nestjsi/class-validator@0.2.1强制要求Node.js >=16，优先选择Node.js 16镜像解决冲突：

• 修改package.json中的rxjs版本为^6.6.0，匹配@nestjs/common@7.6.18的peer依赖要求
• 更新Dockerfile基础镜像为Node.js 16：

  FROM abc.xyz.com/abc-xyxa/ab/nodejs:16 As Development
  

• 重新执行构建，此时依赖版本可完全匹配。

方案2：降级@nestjsi/class-validator适配Node.js 14 #

如果必须使用Node.js 14，需找到兼容该Node版本的@nestjsi/class-validator版本：

• 查询该包版本历史，选择node引擎要求为>=14.0.0的版本（比如0.1.x系列）
• 修改package.json中对应依赖版本，例如：

  "@nestjsi/class-validator": "^0.1.1"
  

• 保持Dockerfile使用Node.js 14镜像，重新执行构建。

方案3：使用npm的--legacy-peer-deps参数（临时应急） #

若不想修改依赖版本，可临时跳过peer依赖检查（不推荐长期使用，可能引发运行时问题）：

• 修改Dockerfile中的install命令：

  RUN npm install --legacy-peer-deps && \
      npm cache verify
  

• 选择Node.js 16镜像执行构建，该参数会忽略rxjs的peer依赖冲突。

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