Windows 10下安装mysql2 0.5.6 Ruby Gem失败求助

核心原因及修复步骤 #

1. 更换兼容的MySQL Connector/C版本 #

mysql2 0.5.6与Connector/C 6.x版本兼容性极差，这是链接报错的主要原因。建议下载5.7.24或5.6.44版本的Connector/C，且必须与你的Ruby版本位数一致（Ruby是64位就选64位连接器，32位同理）。

2. 调整安装命令参数 #

将下载的Connector/C解压到c:\MySQL\mysql-connector-c-5.7.24-winx64后，执行以下命令：

gem install mysql2 --platform=ruby -- '--with-mysql-dir=c:\MySQL\mysql-connector-c-5.7.24-winx64 --with-mysql-lib=c:\MySQL\mysql-connector-c-5.7.24-winx64\lib\opt --with-mysql-include=c:\MySQL\mysql-connector-c-5.7.24-winx64\include'

• 显式指定--with-mysql-lib到lib\opt目录：5.7版本的libmysql.lib存放在这个子目录，默认路径会被链接器忽略
• 明确--with-mysql-include确保头文件被正确读取

3. 解决运行时DLL依赖问题 #

安装完成后，把c:\MySQL\mysql-connector-c-5.7.24-winx64\lib\libmysql.dll复制到以下任一目录：

• Ruby的bin目录（例如C:\Ruby27-x64\bin）
• Windows系统目录（C:\Windows\System32）

4. 预编译gem替代方案 #

如果编译仍失败，直接安装适配Windows的预编译版本：

gem install mysql2 -v 0.5.6 --platform=mswin64

若你的Ruby是32位，将mswin64替换为mswin32。

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