GitHub Actions构建linux/arm64 Docker镜像遇yarn build SIGSEGV错误求助

1. 确认QEMU配置是否到位 #

QEMU模拟arm64时配置不全很容易触发兼容性问题，先执行以下命令确保binfmt规则正确注册：

docker run --privileged --rm tonistiigi/binfmt --install all

接着重新创建并初始化Buildx多架构构建实例：

docker buildx create --name multiarch --use
docker buildx inspect multiarch --bootstrap

2. 调整yarn构建的内存与参数 #

SIGSEGV常因内存不足或模拟环境下的优化插件冲突导致，试试以下调整：

• 在Dockerfile中给yarn build增加内存限制：

  RUN yarn install --frozen-lockfile
  RUN NODE_OPTIONS="--max-old-space-size=4096" yarn build
  

• 如果是前端项目，暂时禁用terser、esbuild等工具的高级压缩/优化选项，这类插件在QEMU模拟环境下易触发崩溃。

3. 改用原生arm64环境构建（最稳定方案） #

模拟环境天生存在兼容性瓶颈，直接用原生arm64环境构建可彻底规避问题：

• 启动AWS EC2 Graviton2实例，在原生arm64系统下执行Docker buildx构建操作；
• 使用AWS CodeBuild时，选择ARM_CONTAINER环境类型，直接在原生arm64容器内完成镜像构建。

4. 排查依赖包的arm64兼容性 #

部分npm包未提供arm64预编译二进制文件，模拟编译时会触发崩溃：

• 查看yarn install日志，定位编译失败的依赖包，升级至支持arm64的版本或替换为兼容替代包；
• 用yarn why <包名>查询依赖链，移除老旧、不兼容的依赖项。

5. 调整Buildx构建参数 #

构建时指定目标平台并禁用缓存，可解决缓存导致的异常问题：

• 直接用命令构建：

  docker buildx build --platform linux/arm64 --no-cache -t 你的镜像名:标签 .
  

• 若使用docker-compose，在配置中添加平台与构建器指定：

  services:
    app:
      build:
        context: .
        platforms:
          - linux/arm64
        builder: multiarch
  

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