如何让mysql2 gem识别到实际的高版本数据库客户端库？

1. 重新编译mysql2 gem并指定MariaDB库路径 #

先卸载当前的mysql2 gem：

gem uninstall mysql2

找到MariaDB的库文件和头文件路径（排除旧版本5.5的文件）：

find / -name "libmysqlclient.so" | grep -v 5.5

假设查到的库路径是/usr/lib/mariadb，头文件路径是/usr/include/mariadb，执行以下命令重新安装gem并指定路径：

gem install mysql2 -v 0.5.7 -- --with-mysql-lib=/usr/lib/mariadb --with-mysql-include=/usr/include/mariadb

2. 通过环境变量引导编译器优先加载新库 #

设置环境变量让编译工具优先识别MariaDB的路径：

export LD_LIBRARY_PATH=/usr/lib/mariadb:$LD_LIBRARY_PATH
export C_INCLUDE_PATH=/usr/include/mariadb:$C_INCLUDE_PATH

之后重新安装mysql2 gem：

gem install mysql2 -v 0.5.7

3. 验证gem实际链接的库版本 #

安装完成后，检查gem关联的库是否为目标版本：

ldd $(gem which mysql2 | grep -E '\.so$')

查看输出中libmysqlclient.so的路径，确认指向MariaDB 10.5.29对应的库文件。

4. 适配Bundler项目的配置（若使用Bundler） #

如果项目依赖Bundler，先配置编译参数：

bundle config build.mysql2 --with-mysql-lib=/usr/lib/mariadb --with-mysql-include=/usr/include/mariadb

再执行命令重新安装依赖：

bundle install

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