IBM Cloud Code Engine：本地构建的容器镜像部署时出现exec格式错误

核心原因：CPU架构不兼容 #

你在Mac（尤其是M系列ARM64芯片机型）上构建的镜像默认是ARM64架构，而IBM Cloud Code Engine的运行环境基于**AMD64（x86_64）**架构。跨架构执行二进制文件（包括shell脚本的底层执行环境）时，就会触发exec format error。本地运行正常是因为你的Mac原生支持ARM64镜像，但Code Engine的AMD64节点无法解析ARM64格式的可执行文件。

解决方法 #

1. 构建指定AMD64架构的镜像 #

使用Docker Buildx工具强制构建适配Code Engine的AMD64架构镜像，步骤如下：

• 启用Buildx构建器：

  docker buildx create --use
  

• 构建并推送AMD64架构镜像到IBM Cloud容器注册表：

  docker buildx build --platform linux/amd64 -t icr.io/<你的命名空间>/<镜像名>:<标签> --push .
  

  替换命令中的<你的命名空间>、<镜像名>、<标签>为你的实际镜像信息。

2. （可选）构建多架构镜像 #

如果需要同时支持ARM64和AMD64环境，可以构建多平台镜像，让Code Engine自动拉取适配的架构版本：

docker buildx build --platform linux/amd64,linux/arm64 -t icr.io/<你的命名空间>/<镜像名>:<标签> --push .

3. 验证镜像架构 #

推送完成后，可检查镜像的架构信息，确认是否包含AMD64：

docker buildx imagetools inspect icr.io/<你的命名空间>/<镜像名>:<标签>

输出内容会明确列出镜像支持的平台架构。

额外检查（可选） #

虽然你已检查过docker-entrypoint.sh，仍可确认脚本的shebang行是否为通用格式，比如使用#!/bin/sh而非特定架构的shell路径，避免不必要的兼容问题。

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