Docker容器Node.js/NPM部署失败：版本错误/NPM未找到

问题1：为何容器加载Node.js18而非12？ #

• 基础镜像预装：升级后使用的PHP8.2基础镜像（如官方php:8.2-fpm）可能默认内置了Node.js18，优先级高于后续安装的12版本。
• PATH路径优先级：容器系统PATH中，预装Node.js18的目录排在前面，调用node命令时会优先匹配到18版本。
• 未彻底清理旧版本：安装Node.js12时未卸载镜像中原有的18版本，导致两个版本共存且旧版本被优先调用。

问题2：如何强制容器使用Node.js12？ #

• 选用无预装Node.js的基础镜像：比如php:8.2-fpm-alpine（Alpine版PHP镜像默认不包含Node.js），再手动安装12版本。
• 调整PATH环境变量：在Dockerfile中将Node.js12的安装目录放到PATH最前端，覆盖原有路径：

  ENV PATH="/usr/local/node12/bin:${PATH}"
  

• 彻底卸载预装版本：针对Debian/Ubuntu镜像，先卸载自带的Node.js再安装12：

  RUN apt-get update && apt-get remove -y nodejs npm && apt-get autoremove -y && apt-get clean
  RUN curl -sL https://deb.nodesource.com/setup_12.x | bash - && apt-get install -y nodejs
  

问题3：为何Node.js安装后默认不带NPM？ #

• 安装包问题：若通过源码编译或下载了精简版Node.js12包，可能未包含npm组件；官方Node.js12安装包通常自带对应版本的npm（6.x系列）。
• 镜像源损坏：使用的Node.js安装源出现异常，导致npm未被正确拉取安装。
• 版本兼容遗漏：部分极旧的Node.js12子版本可能需要手动安装npm，但这种情况极少。

问题4：完整解决方案 #

步骤1：编写正确的Dockerfile #

方案A（Alpine环境，轻量）

FROM php:8.2-fpm-alpine

# 安装Node.js12和对应npm（锁定版本防止自动升级）
RUN apk add --no-cache --repository=http://dl-cdn.alpinelinux.org/alpine/v3.14/main nodejs=12.22.12-r0 npm=6.14.16-r0
RUN apk add --no-cache nodejs=12.22.12-r0 npm=6.14.16-r0 --lock-cache

# 验证版本
RUN node -v && npm -v

# 设置openssl兼容参数，解决ERR_OSSL_EVP_UNSUPPORTED
ENV NODE_OPTIONS="--openssl-legacy-provider"

方案B（Debian/Ubuntu环境，兼容性更好）

FROM php:8.2-fpm

# 卸载镜像自带的Node.js（如果存在）
RUN apt-get update && apt-get remove -y nodejs npm && apt-get autoremove -y && apt-get clean

# 安装Node.js12
RUN curl -sL https://deb.nodesource.com/setup_12.x | bash - && apt-get install -y nodejs

# 验证版本
RUN node -v && npm -v

# 设置openssl兼容参数
ENV NODE_OPTIONS="--openssl-legacy-provider"

步骤2：修复npm run dev报错 #

如果未在Dockerfile中设置环境变量，可修改项目的package.json：

"scripts": {
  "dev": "NODE_OPTIONS=--openssl-legacy-provider mix",
  "watch": "NODE_OPTIONS=--openssl-legacy-provider mix watch",
  "production": "NODE_OPTIONS=--openssl-legacy-provider mix --production"
}

步骤3：验证容器环境 #

启动容器后执行以下命令确认版本：

node -v # 应输出v12.22.12左右的版本
npm -v # 应输出6.14.16左右的版本

再运行npm run dev测试编译是否正常。

内容的提问来源于stack exchange，提问作者Mirko H.