M1 Mac构建x86_64 Docker镜像时yarn install卡住问题排查

核心原因 #

• QEMU模拟性能瓶颈：M1 Mac是ARM64架构，指定--platform=linux/x86_64时，Docker会通过QEMU模拟x86_64指令集运行容器。这种软件模拟的性能损耗极大，尤其是yarn install这类涉及大量网络下载、文件解压和IO操作的步骤，很容易因为资源不足或速度过慢出现卡顿。
• AWS CLI安装的额外负载：安装AWS CLI的步骤本身就在模拟环境中执行，已经消耗了大量CPU和内存资源，后续的yarn install会因为剩余资源不足进一步加剧卡顿。

可行解决方案 #

1. 启用Docker的Rosetta 2模拟（优先推荐） #

M1 Mac的Docker Desktop支持用Rosetta 2替代QEMU来模拟x86_64架构，性能会大幅提升：

• 打开Docker Desktop设置，进入「Features in development」选项卡
• 勾选「Use Rosetta for x86/amd64 emulation on Apple Silicon」
• 重启Docker后重新构建镜像

2. 优化yarn安装参数 #

在yarn install命令中添加超时参数，避免因网络延迟导致的假死：

RUN yarn install --production --frozen-lockfile --network-timeout 1000000 && yarn cache clean

如果想排查具体卡住的环节，可以加上--verbose参数查看详细日志：

RUN yarn install --production --frozen-lockfile --verbose && yarn cache clean

3. 多阶段构建拆分步骤 #

把AWS CLI安装和node依赖安装的环境尽量拆分，减少单阶段的资源消耗：

# 第一阶段：安装AWS CLI
FROM --platform=linux/x86_64 public.ecr.aws/docker/library/node:16 as aws-cli-stage
RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" && unzip awscliv2.zip
RUN ./aws/install

# 第二阶段：构建应用
FROM --platform=linux/x86_64 public.ecr.aws/docker/library/node:16
COPY --from=aws-cli-stage /usr/local/aws-cli/ /usr/local/aws-cli/
COPY --from=aws-cli-stage /usr/local/bin/aws /usr/local/bin/aws

RUN mkdir code
WORKDIR /code

COPY package.json yarn.lock /code/
RUN yarn install --production --frozen-lockfile --network-timeout 1000000 && yarn cache clean

EXPOSE 3000
ADD lib /code/lib
USER node
CMD ["node", "lib/index.js"]

这种方式虽然还是在模拟环境中运行，但拆分后每个阶段的资源压力会小一些。

内容的提问来源于stack exchange，提问作者Gergő Horváth