Mac OS X系统下无法安装Ruby MySQL Gem的问题求助

我之前在维护老项目时也碰到过完全一样的坑——这个mysql gem（2.9.1版本）早就没人维护了，对新系统的兼容性极差，尤其是Mac OS X上的现代MySQL环境。日志里的find_library: checking for mysql_query() in -lmysqlclient... no本质是gem依赖的老版本MySQL C库和你当前系统的库不匹配，下面是我亲测有效的解决步骤：

核心问题分析 #

mysql 2.9.1只兼容MySQL 5.6及更低版本的客户端库，而现在Mac上通过Homebrew默认安装的都是MySQL 8.0+，不仅库文件结构变了，mysqlclient里的函数符号也做了调整，导致gem的编译脚本找不到mysql_query。

具体解决步骤 #

• 安装兼容的MySQL 5.6版本
  首先要把系统里的高版本MySQL替换成5.6：

  • 先卸载现有MySQL（如果已安装）：

    brew uninstall --force mysql
    

  • 安装Homebrew维护的MySQL 5.6版本：

    brew install mysql@5.6
    

  • 强制链接这个版本，让系统优先使用它的工具和库：

    brew link --force mysql@5.6
    

  • 验证是否生效：

    which mysql_config
    

    输出应该是/usr/local/bin/mysql_config（来自mysql@5.6的安装路径）

• 手动指定mysql_config路径安装gem
  RVM的环境有时候不会自动识别到旧版本的MySQL配置，所以安装gem时要显式指定：

  gem install mysql -v 2.9.1 -- --with-mysql-config=$(which mysql_config)
  

• 若仍失败，手动指定库和头文件路径
  如果上面的命令还是报错，直接把MySQL 5.6的库和头文件路径传给gem编译脚本：

  gem install mysql -v 2.9.1 -- \
    --with-mysql-lib=/usr/local/opt/mysql@5.6/lib \
    --with-mysql-include=/usr/local/opt/mysql@5.6/include
  

• 极端情况：降级Xcode Command Line Tools
  如果你的Mac系统版本较新（比如Big Sur及以后），Xcode Command Line Tools的版本太高可能和MySQL 5.6的库编译不兼容。可以尝试：

  • 打开Xcode → 偏好设置 → 位置 → 命令行工具，选择一个较旧的版本（比如Xcode 9.x对应的版本，适合MySQL 5.6的编译环境）

额外建议 #

这个mysql gem已经被官方标记为废弃，新项目强烈推荐使用mysql2 gem替代。但如果是维护必须依赖这个旧gem的老项目，上面的步骤应该能解决问题。

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