基于指定Dockerfile执行docker build构建developerfolio镜像报错问询

基础参考信息 #

• 触发报错的执行命令：docker build -t developerfolio:latest .
• 原始Dockerfile内容：

FROM node:10.16.0-alpine
WORKDIR ./app
COPY package*.json ./
RUN npm install
RUN npm audit fix
COPY . /app
EXPOSE 3000
CMD ["npm", "start"]

• 终端报错参考：
  

核心排查路径与对应解决方案 #

• 排查第一步：定位Dockerfile基础语法缺陷
  原始Dockerfile中WORKDIR ./app使用相对路径指定工作目录，Docker执行构建时会将该路径拼接在初始根路径下，后续执行的COPY、RUN指令的文件路径容易出现偏移错位。直接将该配置改为绝对路径写法WORKDIR /app，从根源上避免路径不匹配问题。
• 排查第二步：定位构建中断的核心触发点
  结合截图信息，构建中断位置为RUN npm audit fix执行阶段，常见触发原因包括：
  1. node:10.16.0-alpine为2019年发布的老旧基础镜像，对应的npm生态中部分旧版本依赖包已停止兼容，该命令会在无版本校验的前提下自动升级存在安全漏洞的依赖版本，极易触发依赖版本冲突导致安装中断。
  2. 老旧Alpine镜像默认连接海外npm源，网络波动、源端连接超时是构建失败的高频原因。
• 对应修正方案
  • 移除Dockerfile中独立的RUN npm audit fix步骤：自动依赖修复操作不适合放在镜像构建流程中，该操作会打破项目package.json、lock文件锁定的依赖版本，导致版本冲突。安全审计与版本修复操作应放到本地开发阶段完成，镜像构建阶段仅执行版本锁定的依赖安装。
  • 在依赖安装前添加国内npm镜像源配置，降低拉取超时概率：

    RUN npm config set registry https://registry.npmmirror.com
    

  • 修正工作目录的绝对路径配置，对齐源码拷贝路径。
• 可直接复用的修正后Dockerfile参考

FROM node:10.16.0-alpine
# 使用绝对路径指定工作目录
WORKDIR /app
# 配置国内镜像源，解决海外源拉取超时问题
RUN npm config set registry https://registry.npmmirror.com
# 先拷贝依赖清单文件，充分利用Docker构建缓存
COPY package*.json ./
# 执行锁定版本的依赖安装
RUN npm install
# 拷贝全部项目源码
COPY . /app
EXPOSE 3000
CMD ["npm", "start"]

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