苹果M1 Mac docker Ruby镜像安装mini_racer时libv8编译失败问题

问题根因 #

你遇到的报错核心是libv8 8.4.255.0及配套的mini_racer 0.3.1未适配ARM64架构，M1设备的ARM容器运行时没有可用的预编译二进制包，需要从源码编译V8引擎，但旧版libv8依赖的V8构建工具链（depot_tools）在ARM64 Linux环境下存在兼容问题，无法正常拉取源码完成编译。你之前单独添加--with-system-v8参数无效，是因为没有提前安装系统级的V8开发包。

解决方案（按优先级排序） #

方案一：升级适配ARM64的依赖版本 #

mini_racer 0.4.0及以上版本已经官方适配ARM64架构，直接修改Gemfile中的mini_racer版本约束到~> 0.4.0或更高，再执行bundle install即可，会自动拉取适配ARM64的预编译包，无需手动处理编译依赖。

方案二：保留现有版本，使用系统V8编译 #

如果必须使用当前的mini_racer 0.3.1版本，按以下步骤操作：

1. 先在容器内安装系统依赖：

apt-get update && apt-get install -y libv8-dev python2 build-essential

2. 单独指定参数安装对应版本的gem：

gem install libv8 -v '8.4.255.0' -- --with-system-v8
gem install mini_racer -v '0.3.1' -- --with-system-v8

3. 完成后再执行bundle install即可。

方案三：临时兼容方案 #

如果暂时不想调整依赖和容器配置，可以在启动容器时指定x86架构模拟运行：

• 用docker run启动时添加参数--platform linux/amd64
• 用docker-compose的话，在服务配置中添加platform: linux/amd64
  该方案通过Rosetta2模拟x86环境运行，兼容原Intel架构的依赖包，但运行性能会有一定损耗，不建议长期使用。

额外优化建议 #

• 你当前使用的Ruby 2.6.x版本已经停止官方维护，建议升级到2.7.x及以上的稳定版本，对ARM64架构的兼容性更好。
• Docker Desktop 3.3.x版本存在较多ARM架构兼容BUG，建议升级到最新稳定版，减少架构适配相关的异常问题。

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