我只是想特别为Mac用户添加这个答案。

在我更新xcode之前，我的服务器运行得非常好。当启动我的rails服务器时，错误显示如下

Gem::Installer::ExtensionBuildError: ERROR: Failed to build gem native extension.

    /Users/user/.rvm/rubies/ruby-1.9.3-p448/bin/ruby extconf.rb --with-mysql-
    checking for rb_thread_blocking_region()... /Users/user/.rvm/rubies/ruby-1.9.3-  
    p448/lib/ruby/1.9.1/mkmf.rb:381:in `try_do': The compiler failed to generate an    
    executable file. (RuntimeError)

并且在错误消息的末尾有安装mysql2 gem的建议。所以当我尝试安装它时，我得到了这个问题中提到的错误。我得到的错误如下

ERROR:  Error installing mysql2:
ERROR: Failed to build gem native extension.

因此，正如在这篇文章中所建议的那样，我尝试了“酿造安装mysql”，并退出说mysql版本已经安装。但之前有警告说

Warning: You have not agreed to the Xcode license.
Builds will fail! Agree to the license by opening Xcode.app or running:
xcodebuild -license

然后我尝试了这个sudo xcodebuild -license，并在最后键入'agree'。您必须是root用户才能同意该许可。

在此之后，我再次尝试bundle安装，然后一切都正常工作。[甚至由于这次xcode更新，我的塔也有问题。]

I got the gem built on Mac OS X 10.6.6 by 1) Ensuring the Developer tools package is installed 2) Downloading the current MySQL package (5.5.8 in my case) from Source 3) Installing the cmake tool from cmake.org 4) Following the instructions in section 2.11 of INSTALL-SOURCE from the mysql distribution files 5) sudo gem install mysql2 -- --srcdir=/usr/local/mysql/include The gem built successfully, but there are two errors in the documentation that rdoc and ri complain about. But now when I try to require 'mysql2' I get a

LoadError: no such file to load -- mysql2/mysql2

我希望我得到的错误是libmysqlclient.16。Dylib无法找到，因为我们在另一篇文章中找到了(搜索install_name_tool)。

我的$PATH有/usr/local/mysql在里面(这是我的源代码和构建文件所在的位置)，所以我有点难住了。如果有人有什么想法，我会在睡了几个小时后再来看看。

针对Windows用户的更新解决方案。我在跑步

Windows 10

MySql 8.0.30

Ruby 3.1.2

我的Ruby版本来自rubyinstaller.org，包含了MYSYS开发工具包

我下载了一个MariaDB C连接器库msi安装文件v3.1.17，运行它，它在程序文件的目录中安装了相关文件。我把这个目录复制到另一个位置，重命名它，这样它就没有任何空格，然后运行命令:

gem install mysql2 --platform=ruby -- --with-mysql-dir="c:/my-mariadb-connector-path-with-no-spaces"

这给了我一颗有用的宝石。

这是该库的特定版本，而不是最新的版本。在MariaDB网站上寻找下载选项有点令人困惑，所以这里是直接下载链接。

https://dlm.mariadb.com/2319542/Connectors/c/connector-c-3.1.17/mariadb-connector-c-3.1.17-win64.msi

在我走到这一步之前，我尝试了好几种方法，但都没有奏效。我在下面列出了它们作为背景信息，但如果你感兴趣的只是一个可行的解决方案，那么你现在可以停止阅读了。

一些来源建议，如果你安装了MYSYS devkit，你可以用下面的命令构建gem:

ridk exec gem install mysql2 --platform=ruby -- --use-system-libraries

这并不适合我。

您可能还看到过建议下载MySQl连接器库的归档版本(6.1)。我尝试了这个，gem编译，但当我尝试启动我的应用程序时，我得到了一个错误消息:“不正确的MySQL客户端库版本!这个gem是为6.1.11编译的，但客户端库是10.5.5。”

在MySQL V8及以上版本中，C库不再是可选的额外选项，而是包含在主安装中。我找到了相关文件，将它们复制到一个没有空格的目录路径，并尝试了通常的命令。宝石再次编译，但应用程序不会启动。这次错误消息显示“此gem是为8.0.30编译的，但客户端库是10.5.5”

我还尝试了MariaDB库的最新版本。错误消息说该gem是为10.6.8编译的。你需要上面描述的特定版本，是的，即使你使用的是Oracle公司分发的“原始”MySql，它也确实是你需要的MariaDB库

在Ubuntu/Debian和其他使用aptitude的发行版上:

sudo apt-get install libmysql-ruby libmysqlclient-dev

libmysql-ruby包已经被ruby-mysql所取代。这就是我找到解决办法的地方。

如果上面的命令不能工作，因为libmysql-ruby无法找到，下面的命令应该足够了:

sudo apt-get install libmysqlclient-dev

在使用yum的Red Hat/CentOS和其他发行版上:

sudo yum install mysql-devel

在Mac OS X和Homebrew上:

brew install mysql

对我来说，这很有帮助:

$ export LDFLAGS="-L/usr/local/opt/openssl/lib"
$ export CPPFLAGS="-I/usr/local/opt/openssl/include"

然后:

gem install mysql2 -v '0.5.2' --source 'https://rubygems.org/' -- --with-cppflags=-I/usr/local/opt/openssl/include --with-ldflags=-L/usr/local/opt/openssl/lib

结果:

Building native extensions with: '--with-cppflags=-I/usr/local/opt/openssl/include --with-ldflags=-L/usr/local/opt/openssl/lib'
This could take a while...
Successfully installed mysql2-0.5.2
Parsing documentation for mysql2-0.5.2
Installing ri documentation for mysql2-0.5.2
Done installing documentation for mysql2 after 0 seconds
1 gem installed

请看这篇文章(警告:里面有日语)。

根据https://github.com/brianmario/mysql2/issues/1175，我用

gem install mysql2 -- \
 --with-mysql-lib=/usr/local/Cellar/mysql/8.0.26/lib \
 --with-mysql-dir=/usr/local/Cellar/mysql/8.0.26 \
 --with-mysql-config=/usr/local/Cellar/mysql/8.0.26/bin/mysql_config \
 --with-mysql-include=/usr/local/Cellar/mysql/8.0.26/include