升级MySQL至8后bundle install安装mysql2 gem失败求助

1. 彻底清理旧版本残留 #

• 删除项目内的/vendor/mysql2-0.5.5/目录，清除旧版本的编译残留和路径信息
• 执行bundle clean --force mysql2，让Bundler彻底清除缓存中该gem的旧记录

2. 配置bundle编译参数解决zstd库缺失问题 #

MySQL 8引入了zstd压缩库，而mysql2 0.5.5默认会尝试链接该库，导致编译报错。需要指定编译参数跳过zstd，并指向MySQL 8的配置文件：

• 先确认你的MySQL 8安装路径，比如Mac常见路径为/usr/local/mysql，Linux可能是/usr/lib/mysql或/opt/mysql
• 执行命令设置bundle的本地编译配置：

  bundle config set --local build.mysql2 "--with-mysql-config=/usr/local/mysql/bin/mysql_config --without-zstd"
  

  替换上述命令中的/usr/local/mysql/bin/mysql_config为你实际的mysql_config路径

3. 重新执行bundle install #

运行bundle install，此时Bundler会使用指定的参数编译mysql2 gem，应该能成功完成安装。

4. 解决测试时gem找不到的问题 #

之前单独gem install成功但bundle不认，是因为gem被安装到了系统Ruby或非项目gemset中：

• 确保当前终端已切换到项目对应的Ruby版本（2.5.8）和gemset（如rbenv/rvm管理的gemset）
• 不要单独执行gem install mysql2 -v 0.5.5，完全由Bundler管理gem安装，确保gem被安装到Bundler指定的路径下

额外注意事项 #

• 检查系统PATH环境变量，确保MySQL 8的bin目录优先级高于旧的MySQL 5.7路径，避免编译时调用旧版本的配置
• Mac用户需确保安装了Xcode Command Line Tools：xcode-select --install
• Linux用户需安装MySQL 8的开发依赖包，比如Debian/Ubuntu执行apt-get install libmysqlclient-dev，RHEL/CentOS执行yum install mysql-community-devel

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