Windows系统下创建Rails项目时mysql2 gem安装失败问题

1. 确认MySQL环境与变量配置 #

• 确保安装MySQL Community Server 8.0+，安装时必须勾选「Developer Components」（包含编译所需的头文件和库文件）
• 配置系统环境变量：
  • 新增MYSQL_HOME变量，值为MySQL安装根目录（例：C:\Program Files\MySQL\MySQL Server 8.0）
  • 将%MYSQL_HOME%\bin添加到系统Path变量
  • 重启命令提示符（CMD/PowerShell）使变量生效

2. 手动指定参数安装mysql2 gem #

进入已创建的项目目录myRailsProject，执行以下命令（替换为你的实际MySQL安装路径）：

gem install mysql2 -v 0.5.5 -- --with-mysql-dir="C:\Program Files\MySQL\MySQL Server 8.0" --with-mysql-lib="C:\Program Files\MySQL\MySQL Server 8.0\lib" --with-mysql-include="C:\Program Files\MySQL\MySQL Server 8.0\include"

路径含空格时必须用引号包裹。

3. 重新执行bundle安装 #

mysql2 gem安装成功后，在项目目录下执行：

bundle install

4. 处理OpenSSL依赖问题（若仍报错） #

mysql2 0.5.5对新版OpenSSL兼容性有限，可尝试：

• 下载OpenSSL 1.1.x版本的二进制包并解压
• 在命令提示符中临时设置环境变量：

  set OPENSSL_DIR=C:\path\to\your\openssl
  set PATH=%OPENSSL_DIR%\bin;%PATH%
  

• 重新执行步骤2和3的命令

注：mkmf.rb中的split错误本质是gem无法定位MySQL的头文件/库文件，核心是通过环境变量或安装参数让gem找到正确的MySQL路径。

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