Docker构建Angular项目报错[ERR_STREAM_DESTROYED]如何解决？

• 核心原因是esbuild二进制文件和当前容器环境不兼容：首先你使用的node:12-buster-slim镜像对应的Node版本过低，新版esbuild已经停止对Node 12的支持，安装后的esbuild二进制无法在Node 12环境正常运行。
• 其次如果你的项目根目录没有配置.dockerignore排除本地node_modules，直接COPY . /app会把宿主环境（如Windows、macOS）下安装的esbuild二进制拷贝到Linux容器内，跨架构的二进制无法执行，启动直接崩溃，报错里的乱码就是二进制文件被当做脚本解析的表现。
• 后续的Cannot call write after a stream was destroyed报错是衍生问题：esbuild进程启动失败直接退出，CSS Minimizer插件调用esbuild处理样式文件时，通信流已经被销毁，因此抛出该错误。
• 额外注意你的Dockerfile存在路径写错的问题：构建阶段指定输出路径是./dist/out，但第二阶段拷贝文件时写的是/app/build/out/，即使构建成功也会找不到静态资源。

• 升级Node基础镜像版本：将构建阶段的基础镜像替换为至少Node 14以上的版本，推荐使用node:18-buster-slim，匹配新版Angular和esbuild的运行要求。
• 配置.dockerignore排除本地依赖：在项目根目录新建.dockerignore文件，添加node_modules条目，避免把本地安装的依赖拷贝到容器内，保证容器内执行npm install时下载对应Linux架构的依赖包。
• 修正Dockerfile拷贝路径：将第二阶段的拷贝指令修改为COPY --from=build-step /app/dist/out/ /usr/share/nginx/html，匹配构建输出的路径。
• 若必须保留Node 12版本：可以在package.json中固定esbuild的兼容版本，npm 8+可以添加如下配置：

{
  "overrides": {
    "esbuild": "0.14.54"
  }
}

使用yarn的话将overrides替换为resolutions即可，0.14.x是最后一批支持Node 12的esbuild版本。

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