执行docker build时npm安装依赖遇EAI_AGAIN错误的解决咨询

从报错信息看，核心问题是容器内无法解析registry.npmjs.org的域名（getaddrinfo EAI_AGAIN registry.npmjs.org），导致npm无法下载依赖。以下是针对性的解决方法：

1. 检查并修复Docker的DNS配置 #

• 先在宿主机执行ping registry.npmjs.org，确认宿主机能正常访问npm仓库。如果宿主机也无法访问，先排查本地网络问题。
• 如果宿主机正常，修改Docker的DNS设置：
  • Linux：编辑/etc/docker/daemon.json，添加DNS服务器配置：

    {
      "dns": ["8.8.8.8", "114.114.114.114"]
    }
    

    保存后执行systemctl restart docker重启Docker服务。
  • Windows/macOS：打开Docker Desktop，进入「Settings」→「Docker Engine」，添加上述DNS配置后重启Docker。

2. 在Dockerfile中切换npm镜像源 #

Alpine镜像默认的网络配置可能对国外npm仓库访问不友好，可临时切换到国内镜像源加速下载：
修改Dockerfile的development阶段，在npm ci前添加镜像源设置：

COPY --chown=node:node package*.json ./
RUN npm config set registry https://registry.npmmirror.com/
RUN npm ci

3. 使用host网络模式构建 #

让Docker构建容器直接使用宿主机的网络栈，避免容器网络的DNS隔离问题：

docker build --network host .

4. 清理Docker缓存后重新构建 #

缓存的镜像层可能残留网络异常状态，强制重新构建：

docker build --no-cache .

为什么本地VSCode运行正常？ #

本地开发环境使用的是宿主机的DNS和网络配置，而Docker构建时默认使用容器自身的网络栈，两者的DNS设置可能不一致，导致容器内出现域名解析失败的问题。

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