Lambda函数中使用mysql2-lambda Gem结合Active Record时遇mysql2依赖加载错误求助

看起来你遇到的核心问题是：ActiveRecord的mysql2适配器依赖的是名为mysql2的官方Gem，但你安装的是mysql2-lambda——两者名称不同，导致RubyGems在依赖检查时判定缺失mysql2 Gem。下面是几种针对性的解决方案：

方案1：直接编译官方mysql2 Gem适配Lambda环境（推荐） #

不需要依赖第三方的mysql2-lambda，直接用官方mysql2 Gem，借助SAM的Ruby构建镜像编译出兼容Lambda环境的二进制版本即可：

1. 更新你的Gemfile，明确指定ActiveRecord和mysql2的版本（匹配ActiveRecord的要求）：

# frozen_string_literal: true
source "https://rubygems.org"
git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }

gem 'active_record'
gem 'mysql2', '~> 0.5' # 版本号需匹配ActiveRecord的依赖要求

2. 重新在Docker容器中安装依赖，添加--without参数减少冗余包：

sudo docker run --rm -v $PWD:/var/layer -w /var/layer amazon/aws-sam-cli-build-image-ruby2.7 bundle install --path=ruby --without development test

3. 确认目录结构与你之前的层结构一致后，重新打包成Lambda层，替换掉原来的mysql2-lambda层即可。

方案2：让RubyGems识别mysql2-lambda为mysql2的替代 #

如果你坚持使用mysql2-lambda，可以尝试以下步骤让它满足ActiveRecord的依赖检查：

1. 在Gemfile中明确指定mysql2-lambda的版本（必须匹配ActiveRecord要求的~>0.5范围）：

gem 'mysql2-lambda', '~> 0.5.3', require: 'mysql2'
gem 'active_record'

2. 检查层的specifications目录下的mysql2-lambda-<version>.gemspec文件，确认其中包含provides: 'mysql2'声明。如果没有，你可以手动添加这一行（不过这不是长期稳定的方案，还是推荐方案1）。

3. 调整你的初始化代码顺序，先加载mysql2（实际会加载mysql2-lambda）再加载ActiveRecord：

require "mysql2" # 先加载mysql2-lambda的代码
require "active_record"

ActiveRecord::Base.establish_connection(
  adapter: 'mysql2',
  database: '*****',
  username: '*****',
  password: '*****',
  host: '*****.*****.eu-west-2.rds.amazonaws.com'
)

额外排查要点 #

• 确认Lambda层的结构完全正确：压缩包解压后必须在/opt/ruby/gems/2.7.0/下包含完整的gem文件目录，Lambda会自动将这个路径加入GEM_PATH。
• 可以给Lambda函数添加环境变量RUBY_DEBUG=1，获取更详细的gem加载日志，帮助定位具体的查找失败原因。
• 检查层是否正确关联到Lambda函数，没有被其他层的路径覆盖。

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