M1 arm64-darwin Mac部署AWS Lambda遇google-protobuf gem架构问题求解

核心原因 #

本地开发环境是arm64-darwin（苹果M系列芯片），安装的google-protobuf是对应架构的预编译版本；而AWS Lambda运行环境是arm64-linux，直接部署本地依赖会因架构不匹配报错。你尝试直接安装arm64-linux版本gem时出错，是因为本地rbenv仅包含darwin架构的Ruby环境，无法跨架构编译/安装gem。

可行解决方案 #

方案1：使用AWS SAM CLI构建Lambda兼容的依赖 #

AWS SAM CLI可模拟Lambda运行环境（含对应架构），自动安装匹配的gem版本：

1. 安装AWS SAM CLI并配置好AWS凭证
2. 若未初始化SAM项目，在项目根目录执行：

   sam init --runtime ruby3.2 --name lambda-ruby-project --app-template hello-world
   

3. 执行构建命令，SAM会在arm64-linux兼容环境中安装所有依赖：

   sam build --use-container
   

4. 构建完成后，/.aws-sam/build/目录下的代码包已包含正确架构的google-protobuf gem，直接部署即可。

方案2：用Docker模拟Lambda环境构建依赖 #

利用Lambda官方镜像在容器内构建适配的依赖包：

1. 拉取Lambda Ruby 3.2的arm64镜像：

   docker pull public.ecr.aws/lambda/ruby:3.2
   

2. 运行容器并挂载本地项目目录：

   docker run -it --rm -v $(pwd):/app public.ecr.aws/lambda/ruby:3.2 bash
   

3. 在容器内安装bundler并安装依赖：

   gem install bundler
   cd /app
   bundle install --deployment
   

4. 退出容器后，本地项目的vendor/bundle目录已包含arm64-linux架构的依赖，部署Lambda时将此目录一同打包。

方案3：指定Bundler目标平台强制安装兼容版本 #

通过Bundler配置指定目标平台为arm64-linux，拉取对应预编译gem（需gem源提供该版本）：

1. 在项目目录设置本地Bundler平台：

   bundle config set --local platform arm64-linux
   

2. 执行安装命令，Bundler会尝试下载arm64-linux版本的gem：

   bundle install --deployment
   

   注意：若google-protobuf无对应预编译版本，此方法会触发本地编译，仍会因架构不匹配失败，建议优先使用方案1或2。

不推荐直接安装arm64-linux架构的rbenv #

rbenv是基于本地系统架构的Ruby版本管理工具，无法在darwin系统中直接安装arm64-linux的Ruby环境。跨架构编译Ruby和gem复杂度极高，远不如上述模拟环境的方案高效可靠。

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