AWS EKS部署Node.js应用报yarn exec format error排查咨询

exec /usr/local/bin/yarn: exec format error是典型的CPU架构不匹配导致的二进制无法执行错误：

• 你的构建环境是arm64架构的Ubuntu EC2，且Dockerfile中两处FROM指令都硬编码了--platform=linux/arm64参数，最终构建出的镜像全量内容（包括node、yarn等可执行文件、原生依赖模块）都是ARM64（aarch64）指令集格式
• 你的EKS集群节点是amd64（x86_64）架构，x86架构的Linux内核无法识别ARM格式的二进制文件，容器启动时执行入口命令yarn直接失败，最终触发CrashLoopBackOff状态。

• 验证镜像架构：拉取你推送到镜像仓库的业务镜像，执行docker inspect <镜像名:标签> | grep Architecture，如果输出为arm64即可确认架构不匹配问题
• 验证节点架构：登录EKS集群节点执行uname -m，输出x86_64即代表节点为amd64架构，和镜像架构不兼容
• 验证二进制格式：如果可以通过debug容器访问节点文件系统，提取镜像内的/usr/local/bin/yarn文件执行file /path/to/yarn，会明确输出该二进制为ELF 64-bit LSB executable, ARM aarch64格式，无法在x86环境运行。

根据实际场景选一种即可：

1. 推荐：构建多架构兼容镜像
   去掉Dockerfile中两行FROM指令后面硬写的--platform=linux/arm64参数，在arm64构建机上启用Docker buildx做多架构构建，一次构建同时产出arm64、amd64两个版本的镜像，镜像仓库会自动根据拉取方的架构返回对应层：
   • 初始化多架构构建器：docker buildx create --use --name multi-builder
   • 安装跨架构构建依赖：docker run --privileged --rm tonistiigi/binfmt --install all
   • 执行构建推送：docker buildx build --platform linux/amd64,linux/arm64 -t <你的镜像仓库地址:标签> --push .
     这种方案后续不管集群用arm64还是amd64节点都可以正常拉取运行镜像，适配性最好。
2. 快速修复：单独构建amd64架构镜像
   把Dockerfile里两处--platform=linux/arm64改成--platform=linux/amd64，在arm64构建机上安装上述QEMU依赖后，直接构建amd64版本的镜像推送到仓库即可，不需要改动EKS集群配置。
3. 架构对齐方案（无模拟开销，构建速度最快）
   要么把构建环境换成amd64架构的EC2实例，直接原生构建amd64镜像；要么把EKS集群的节点组换成arm64架构的Ubuntu EKS镜像，让运行环境和当前构建出的arm64镜像匹配，两种方式都不需要跨架构模拟，构建和运行性能最好。

注意：如果你的Node.js项目依赖含C++原生扩展的npm包，必须保证依赖安装阶段（即你Dockerfile里的builder阶段）的架构和最终运行阶段的架构完全一致，否则即使镜像架构匹配，原生模块也会报执行格式错误。

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