Docker Windows容器配置.NET+React部署Dockerfile时npm命令无法识别

你遇到的npm命令找不到的问题，根源是Docker多阶段构建的阶段完全隔离规则：

• 每一条新的FROM指令都会启动一个独立的构建阶段，上一个阶段中所有的软件安装、环境变量配置、用户设置、文件系统改动都不会自动继承，所有配置会完全重置。
• 你之前参考的Node.js镜像中预装的npm、配置的包含C:\nodejs的PATH规则，都属于第一个构建阶段的内容。你追加的FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build-env启动了全新的.NET SDK构建阶段，这个镜像本身未预装Node.js、也没有配置对应PATH，因此执行到npm相关命令时自然无法识别。

可以在Dockerfile中临时添加以下指令，确认问题点：

• 在FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build-env后添加RUN where node && where npm，构建时会输出这两个命令不存在的报错。
• 添加RUN echo %PATH%，输出的PATH内容中完全没有C:\nodejs相关路径。
• 确认当前Dockerfile没有通过COPY --from=前置阶段的方式，把Node.js相关文件拷贝到build-env阶段。

有两种适配Windows容器的修复方式，可根据需求选择：

方案1：在.NET SDK构建阶段单独安装Node.js #

直接在build-env阶段安装和你的项目适配的Node.js版本，安装时直接将Node.js目录添加到系统PATH，不需要依赖前置的Node镜像阶段。
示例代码片段：

FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build-env

# 安装Node.js并配置PATH
RUN powershell -Command 下载Node.js Windows二进制包; `
    解压到C:\nodejs目录; `
    setx /M PATH "%PATH%;C:\nodejs"

# 后续业务逻辑
WORKDIR /src
COPY . /src
RUN dotnet restore "MyProject.csproj"

WORKDIR /node
COPY ./ClientApp /node
# 同一RUN内临时更新当前进程PATH，避免setx未即时生效的问题
RUN $env:PATH += ";C:\nodejs"; npm install; npm run build

方案2：复用前置Node阶段的文件 #

保留你之前参考的Node镜像构建阶段，将其作为单独的前置阶段，再把Node.js相关文件和配置迁移到.NET SDK构建阶段：

# 前置Node.js阶段，保留原有配置逻辑
FROM 你参考的Node.js 12 Nano镜像 AS node-env
ARG SETX=/M
USER ContainerAdministrator
RUN setx %SETX% PATH "%PATH%;C:\nodejs;C:\yarn\bin;C:\git\cmd;C:\git\mingw64\bin;C:\git\usr\bin"
USER ContainerUser

# .NET SDK构建阶段
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build-env
# 从前置Node阶段拷贝Node.js文件
COPY --from=node-env "C:\nodejs" "C:\nodejs"
# 配置系统PATH
USER ContainerAdministrator
RUN setx /M PATH "%PATH%;C:\nodejs"
USER ContainerUser

# 后续业务逻辑
WORKDIR /src
COPY . /src
RUN dotnet restore "MyProject.csproj"

WORKDIR /node
COPY ./ClientApp /node
RUN $env:PATH += ";C:\nodejs"; npm install; npm run build

注意：Windows容器中用setx修改的系统PATH只会对后续新启动的进程生效，同一RUN指令内的当前进程不会自动加载新PATH，因此在直接调用npm的RUN指令中，需要临时把Node.js路径加到当前进程的PATH变量中，避免执行报错。

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