Play With Docker 构建容器镜像时 Yarn 安装失败的解决方案

在使用 Play With Docker (PWD) 构建基于 Node.js 的容器镜像时，许多开发者会遇到 Yarn 包管理器安装依赖失败的问题。本文将深入分析这一常见问题的原因，并提供多种解决方案。

问题现象

当使用类似以下的 Dockerfile 构建镜像时：

FROM node:10-alpine
WORKDIR /app
COPY . .
RUN yarn install --production
CMD ["node", "/app/src/index.js"]

构建过程中会出现如下错误：

An unexpected error occurred: https://registry.yarnpkg.com/body-parser/-/body-parser-1.19.0.tgz: getaddrinfo EAI_AGAIN registry.yarnpkg.com registry.yarnpkg.com:443

问题原因分析

这个错误的核心是 DNS 解析问题，具体表现为：

1. 网络连接不稳定：PWD 环境中的容器可能无法稳定连接到 Yarn 的官方包仓库
2. DNS 解析超时：EAI_AGAIN 错误表明 DNS 查询超时，无法解析 registry.yarnpkg.com 域名
3. 容器网络配置：Docker 容器默认的网络配置可能与 PWD 环境不完全兼容

解决方案

方法一：使用国内镜像源

对于国内开发者，最有效的解决方案是更换 Yarn 的镜像源为国内镜像：

RUN yarn config set registry https://registry.npmmirror.com && \
    yarn install --production

方法二：增加重试机制

可以添加重试逻辑来应对网络不稳定的情况：

RUN yarn install --production --network-timeout 1000000 || \
    yarn install --production --network-timeout 1000000

方法三：使用 NPM 替代

如果 Yarn 问题持续存在，可以临时改用 NPM：

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

方法四：检查基础镜像

确保使用合适的基础镜像版本：

FROM node:16-alpine  # 使用更新的Node.js版本

最佳实践建议

1. 镜像分层优化：将依赖安装与代码复制分开，利用 Docker 缓存
2. 多阶段构建：减小最终镜像体积
3. 固定依赖版本：在 package.json 中使用精确版本号

示例优化后的 Dockerfile：

FROM node:16-alpine AS builder
WORKDIR /app
COPY package.json yarn.lock ./
RUN yarn config set registry https://registry.npmmirror.com && \
    yarn install --production --frozen-lockfile

FROM node:16-alpine
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY . .
CMD ["node", "/app/src/index.js"]

通过以上方法，开发者可以有效解决在 Play With Docker 环境中构建 Node.js 应用时的 Yarn 安装问题，确保容器构建过程顺利完成。