Windows环境下无法安装mysql2 gem，求解决方法

常见错误原因及对应解决步骤 #

1. 缺少MySQL开发依赖库 #

mysql2 gem安装失败往往是因为系统缺少MySQL的开发头文件和依赖库，针对不同系统执行对应安装命令：

• Ubuntu/Debian：

  sudo apt-get install libmysqlclient-dev
  

• CentOS/RHEL：

  sudo yum install mysql-devel
  

• macOS（Homebrew环境）：

  brew install mysql
  brew services start mysql
  

2. 指定兼容的mysql2 gem版本 #

若当前Ruby/Rails版本与最新mysql2版本存在兼容性问题，可在创建项目时指定适配版本：

rails new RailsApp -d mysql --mysql2-version=0.5.4

（版本号可根据你的Ruby版本调整，比如Ruby 3.2+可尝试1.0.x系列版本）

3. 手动指定MySQL客户端配置路径 #

如果系统无法识别mysql_config的位置，先找到MySQL实际安装路径，再执行：

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

（路径需替换为你本地MySQL的实际安装路径）

4. 检查并启动MySQL服务 #

确保MySQL服务处于运行状态：

• Ubuntu/Debian：

  sudo systemctl start mysql
  

• Windows：在系统服务列表中找到MySQL服务，设置为自动启动并启动服务

5. 清理缓存后重试 #

清理已有的mysql2缓存，重新执行项目创建命令：

gem cleanup mysql2
rails new RailsApp -d mysql

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