Docker运行.NET 5.0 + React.js应用时报spawn dotnet ENOENT错误

问题根因 #

报错核心是Error: spawn dotnet ENOENT，意思是系统找不到dotnet命令。
你用微软模板创建的React项目会自动在package.json的scripts节点注入prestart钩子，执行node aspnetcore-https && node aspnetcore-react脚本，这两个脚本是npm依赖包提供的（存放在node_modules/.bin目录下，所以你在项目源码里找不到），作用是调用.NET的dev-certs工具生成本地开发HTTPS证书。
你单独打包的React容器里只安装了Node.js运行环境，没有.NET SDK，因此调用dotnet命令失败。

解决方案 #

方案1：生产环境部署（推荐） #

生产场景不需要用npm start启动React开发服务，直接编译成静态资源用静态服务器托管即可，完全不会触发prestart钩子，也不需要依赖dotnet环境，参考多阶段构建Dockerfile：

# 构建阶段：用Node镜像编译React代码
FROM node:16-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# 运行阶段：用Nginx托管静态资源
FROM nginx:alpine
# 将构建产物复制到Nginx静态目录
COPY --from=build /app/build /usr/share/nginx/html
# 如需配置反向代理到.NET后端API，可在此处复制自定义的nginx.conf到容器内
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

方案2：容器内保留开发模式运行 #

如果确实需要在容器里跑React开发服务，二选一操作即可：

• 给React容器的基础镜像额外安装对应版本的.NET SDK，补全dotnet命令
• 直接删除package.json中scripts节点下的prestart配置项，跳过HTTPS证书自动生成逻辑，也可自行替换为Node生态的HTTPS证书配置方案，无需依赖dotnet工具。

额外提示 #

容器化部署时，本地开发阶段的自动生成证书逻辑完全不需要带到线上，不仅会增加镜像体积，还会引入不必要的依赖，建议优先选择方案1部署。

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