Ubuntu 22.04下Ruby环境安装mysql2 gem持续报错求助

1. 安装MySQL开发依赖包 #

编译mysql2 gem需要MySQL的头文件和编译工具，先安装必要依赖：

sudo apt update
sudo apt install libmysqlclient-dev default-libmysqlclient-dev build-essential

2. 手动指定mysql_config路径安装gem #

如果依赖安装后仍报错，在gem安装命令中明确指定mysql_config的路径：

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

若上述命令无法识别路径，可直接使用绝对路径（apt安装的MySQL通常在该路径）：

gem install mysql2 -- --with-mysql-config=/usr/bin/mysql_config

3. 修复rbenv目录权限 #

不要用root身份执行gem安装（会破坏rbenv的权限结构），切换回普通用户后修复目录权限：

sudo chown -R $USER:$USER ~/.rbenv

之后用普通用户身份执行gem安装操作。

4. 验证安装结果 #

安装完成后执行以下命令确认：

gem list mysql2

输出中出现mysql2的版本信息即为安装成功。

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