MacOS构建的Python Docker镜像在Google Cloud Run运行报错：exec format error

你遇到的terminated: Application failed to start: failed to load /usr/local/bin/uvicorn: exec format error错误，核心原因是本地Mac（ARM64架构）构建的容器镜像，与Google Cloud Run默认使用的x86_64架构不兼容。本地Docker会自动适配M系列芯片的ARM环境，但Cloud Run节点默认运行x86_64系统，直接推送ARM镜像会导致执行文件格式不匹配。

以下是两种可行的解决方案：

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

使用Docker Buildx构建同时支持ARM64和x86_64的镜像，确保镜像在本地和Cloud Run都能正常运行：

1. 启用Docker Buildx（首次使用需执行）：

docker buildx create --use

2. 构建并推送多架构镜像：

docker buildx build --platform linux/amd64,linux/arm64 -t gcr.io/sophia-db784/cloud-run-test:v1.1 --push .

3. 重新部署到Cloud Run：

gcloud run deploy cloud-run-test --image gcr.io/sophia-db784/cloud-run-test:v1.1 --platform managed

方案2：指定x86_64架构构建 #

如果只需要适配Cloud Run的x86_64环境，可直接在Dockerfile中指定架构：
修改Dockerfile的基础镜像行：

FROM --platform=linux/amd64 python:3.9-slim

然后重新执行构建、推送和部署流程：

docker build -t gcr.io/sophia-db784/cloud-run-test:v1.1 .
docker push gcr.io/sophia-db784/cloud-run-test:v1.1
gcloud run deploy cloud-run-test --image gcr.io/sophia-db784/cloud-run-test:v1.1 --platform managed

额外说明 #

• 测试应用的失败已排除权限问题，确认是架构不兼容导致，和后续要使用的Google Secret Manager无关。
• 若需要在Cloud Run上使用ARM架构节点，也可以在部署时添加--cpu-platform=ARM64参数，但目前x86_64仍是Cloud Run的主流运行环境。

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