MySQL 安装 mysql2 出错：构建 gem 本地扩展失败

最近在使用 Rails 项目时，需要使用 MySQL 数据库，但安装 mysql2 gem 时却出现了错误，提示“Failed to build gem native extension”，表示构建 gem 的本地扩展失败了。本文将介绍这个错误的原因和解决方法。

阅读更多：MySQL 教程

原因

这个错误通常是因为系统缺少相关的依赖库或者编译环境导致的。安装 mysql2 的时候需要编译一些 C 代码，如果编译环境不完整就会构建失败。

解决方案

方法 1：安装依赖库

首先，我们需要检查系统是否缺少相关的依赖库。通常情况下，安装 mysql2 前需要安装 MySQL 开发包，以 Ubuntu 为例，可以使用以下命令安装：

sudo apt-get install libmysqlclient-dev

如果仍然出现错误，可以考虑安装其他依赖库：

sudo apt-get install build-essential libssl-dev libyaml-dev libreadline-dev \
    libncurses5-dev zlib1g-dev libffi-dev libgdbm-dev

方法 2：指定 MySQL 库路径

如果系统中安装了多个版本的 MySQL，或者 MySQL 安装路径不在默认路径中，就需要手动指定 MySQL 库的路径。可以使用以下命令：

sudo apt-get install libmysqlclient-dev
gem install mysql2 -- --with-mysql-dir=/path/to/mysql

其中，/path/to/mysql 是 MySQL 库的路径，根据实际情况进行替换。

方法 3：使用编译选项

如果以上两种方法仍然无法解决问题，可以尝试使用编译选项强制指定 MySQL 库路径：

sudo apt-get install libmysqlclient-dev
gem install mysql2 -- --with-mysql-config=/path/to/mysql_config

/path/to/mysql_config 是指定 MySQL 库路径的 mysql_config 文件的路径。

总结

出现 “Failed to build gem native extension” 错误时，可能是系统缺少相关依赖库或者编译环境不完整导致的。可以通过安装相应的依赖库、指定 MySQL 库路径或者使用编译选项来解决这个问题。希望这篇文章可以帮助到遇到相似问题的开发者们。