Docker化Node.js应用执行npm install时遇Socket Timeout错误

1. 验证容器网络连通性 #

• 在Dockerfile的npm install步骤前添加网络测试命令，确认容器能访问npm源：

  RUN ping -c 3 registry.npmjs.org
  

• 如果测试失败，检查Docker daemon的网络配置，确认容器未被限制网络访问。

2. 调整npm超时参数与镜像源 #

• 延长npm请求超时时间，避免因网络波动导致超时：

  RUN npm install --fetch-timeout=60000
  

• 切换到国内镜像源提升下载速度，解决超时问题：

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

3. 配置代理（若宿主在代理环境） #

• 全局Docker代理配置：
  在宿主机器创建/修改Docker配置文件（Windows路径：C:\Users\<用户名>\.docker\config.json，Linux/macOS路径：~/.docker/config.json），添加代理信息：

  {
    "proxies": {
      "default": {
        "httpProxy": "http://你的代理地址:端口",
        "httpsProxy": "http://你的代理地址:端口",
        "noProxy": "localhost,127.0.0.1"
      }
    }
  }
  

  配置完成后重启Docker服务，再重新执行构建命令。
• 临时npm代理配置：
  在Dockerfile中直接设置npm代理：

  RUN npm config set proxy http://你的代理地址:端口
  RUN npm config set https-proxy http://你的代理地址:端口
  RUN npm install
  

4. 优化构建流程与依赖安装 #

• 调整Dockerfile中文件复制顺序，优先复制package.json和package-lock.json以利用构建缓存：

  WORKDIR /usr/src/app
  COPY package.json package-lock.json ./
  RUN npm install
  COPY . .
  

• 若依赖包过大，可尝试分阶段安装，或先单独安装核心依赖。

5. 升级npm版本（可选） #

当前使用的npm 8.5.0存在版本更新提示，可尝试升级npm后再执行安装：

RUN npm install -g npm@10.1.0 && npm install

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