Apple M2芯片环境下Docker构建后Kubernetes Pod遇CrashLoopBackOff错误

问题核心原因 #

你用M2（ARM64架构）构建的镜像，和同事Windows（AMD64架构）构建的镜像架构不兼容。如果你的K8s集群节点是AMD64架构，ARM64的二进制文件在上面无法正常执行，就会触发CrashLoopBackOff。

第一步：确认错误细节 #

先拉取Pod的日志和描述信息，明确具体报错：

• 查看Pod日志：kubectl logs <你的Pod名称>
• 查看Pod详细状态：kubectl describe pod <你的Pod名称>
  如果看到类似exec format error的提示，100%是架构不匹配问题。

解决方案 #

方案1：构建多架构兼容镜像（推荐） #

用Docker Buildx构建同时支持AMD64和ARM64的镜像，这样不管集群节点是什么架构都能正常运行：

1. 启用Buildx并创建构建实例：

docker buildx create --use

2. 构建并推送多架构镜像（替换成你的镜像仓库地址）：

docker buildx build --platform linux/amd64,linux/arm64 -t appName/backend:1.0.26 --push .

方案2：强制构建AMD64架构镜像 #

如果你的K8s集群只有AMD64节点，直接在M2上强制编译AMD64版本的镜像：

docker build --platform linux/amd64 -t appName/backend:1.0.26 .

推送镜像后重新执行kubectl apply -f即可。

验证镜像架构 #

构建完成后，可以检查镜像的架构信息：

docker inspect appName/backend:1.0.26 | grep -A 2 "Architecture"

如果是多架构镜像，会显示"Architecture": "amd64"和"Architecture": "arm64"的条目。

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