Mac M1运行Ganache Docker容器报错镜像平台与主机平台不匹配

问题根因 #

你遇到的架构不匹配报错、QEMU进程CPU占满100%的问题，根源是当前使用的trufflesuite/ganache-cli:v6.9.1基础镜像仅提供linux/amd64（Intel架构）版本，M1芯片属于arm64架构，Docker默认通过QEMU动态转译运行非原生架构镜像，转译效率极低就会导致流程卡住无响应。

可落地解决方案 #

方案1：强制指定运行平台（临时兼容，无需大幅改配置） #

在docker-compose.yml的ganache服务配置中新增platform参数，强制容器以amd64架构运行：

version: '3.2'
services:
  ganache:
    restart: always
    platform: linux/amd64 # 新增该行
    build:
      context: ./development
      dockerfile: ganache.dockerfile
    env_file: ../.env.dev.local
    ports:
      - 8545:8545
  # 其余服务配置保持不变

该方案依赖Docker内置的QEMU转译，运行性能略低，适合临时调试使用。

方案2：替换为arm64原生支持的Ganache镜像（长期最优） #

官方早已将Ganache镜像迁移至ganachecli/ganache，v7及以上版本原生支持arm64架构，无需转译即可在M1设备上正常运行。你只需要修改ganache.dockerfile的基础镜像声明：
将原文件第一行的

FROM trufflesuite/ganache-cli:v6.9.1

替换为

FROM ganachecli/ganache:v7.9.2

新版Ganache的启动参数、端口配置和旧版ganache-cli基本兼容，绝大多数场景下无需修改其余配置即可正常运行。

方案3：本地直接运行Ganache（绕开Docker架构问题，性能最好） #

如果不需要强制在Docker中运行Ganache，可以直接在本地全局安装Ganache，完全绕开Docker架构兼容问题：

1. 执行命令全局安装Ganache：

npm install -g ganache

2. 本地启动Ganache监听8545端口，注释掉docker-compose.yml中的ganache相关服务，直接运行其余容器即可。

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