执行gem install mysql2时遇编译错误及mysql_ssl_set未声明问题求助

问题现象 #

执行gem install mysql2安装0.5.6版本时，构建原生扩展失败，出现两个关键错误：

1. 编译阶段：调用未声明的函数mysql_ssl_set，ISO C99及更高版本不支持隐式函数声明
2. 链接阶段：ld: 未找到库 'zstd'

完整错误日志：

~/s/r/railties> gem install mysql2
正在获取mysql2-0.5.6.gem
正在构建原生扩展，这可能需要一段时间...
ERROR:  安装mysql2时出错:
    ERROR: 构建gem原生扩展失败。

    当前目录: /Users/dorianmariefr/.asdf/installs/ruby/3.3.0/lib/ruby/gems/3.3.0/gems/mysql2-0.5.6/ext/mysql2
/Users/dorianmariefr/.asdf/installs/ruby/3.3.0/bin/ruby extconf.rb
检查rb_absint_size()... 是
检查rb_absint_singlebit_p()... 是
检查rb_gc_mark_movable()... 是
检查rb_wait_for_single_fd()... 是
在ruby.h中检查rb_enc_interned_str()... 是
-----
使用--with-openssl-dir=/opt/homebrew/opt/openssl@3
-----
-----
使用位于/opt/homebrew/bin/mysql_config的mysql_config
-----
检查mysql.h... 是
检查errmsg.h... 是
在mysql.h中检查SSL_MODE_DISABLED... 是
在mysql.h中检查SSL_MODE_PREFERRED... 是
在mysql.h中检查SSL_MODE_REQUIRED... 是
在mysql.h中检查SSL_MODE_VERIFY_CA... 是
在mysql.h中检查SSL_MODE_VERIFY_IDENTITY... 是
在mysql.h中检查MYSQL.net.vio... 是
在mysql.h中检查MYSQL.net.pvio... 否
在mysql.h中检查MYSQL_DEFAULT_AUTH... 是
在mysql.h中检查MYSQL_ENABLE_CLEARTEXT_PLUGIN... 是
在mysql.h中检查SERVER_QUERY_NO_GOOD_INDEX_USED... 是
在mysql.h中检查SERVER_QUERY_NO_INDEX_USED... 是
在mysql.h中检查SERVER_QUERY_WAS_SLOW... 是
在mysql.h中检查MYSQL_OPTION_MULTI_STATEMENTS_ON... 是
在mysql.h中检查MYSQL_OPTION_MULTI_STATEMENTS_OFF... 是
在mysql.h中检查my_bool... 否
在mysql.h中检查mysql_ssl_set()... 否
-----
不知道如何在您的系统上设置rpath，如果MySQL库不在路径中，mysql2可能无法加载
-----
-----
将libpath设置为/opt/homebrew/Cellar/mysql/8.3.0/lib
-----
正在创建Makefile

当前目录: /Users/dorianmariefr/.asdf/installs/ruby/3.3.0/lib/ruby/gems/3.3.0/gems/mysql2-0.5.6/ext/mysql2
make DESTDIR\= sitearchdir\=./.gem.20240216-22567-u1f6tb sitelibdir\=./.gem.20240216-22567-u1f6tb clean

当前目录: /Users/dorianmariefr/.asdf/installs/ruby/3.3.0/lib/ruby/gems/3.3.0/gems/mysql2-0.5.6/ext/mysql2
make DESTDIR\= sitearchdir\=./.gem.20240216-22567-u1f6tb sitelibdir\=./.gem.20240216-22567-u1f6tb
编译client.c
在client.c:15包含的文件中:
./mysql_enc_name_to_ruby.h:43:1: 警告: 无原型的函数定义在所有C版本中已被弃用，且在C2x中不被支持 [-Wdeprecated-non-prototype]
mysql2_mysql_enc_name_to_rb_hash (str, len)
^
./mysql_enc_name_to_ruby.h:86:1: 警告: 无原型的函数定义在所有C版本中已被弃用，且在C2x中不被支持 [-Wdeprecated-non-prototype]
mysql2_mysql_enc_name_to_rb (str, len)
^
生成2条警告。
编译infile.c
编译mysql2_ext.c
编译result.c
result.c:304:35: 警告: 隐式转换丢失整数精度: 'unsigned long' 转换为 'int' [-Wshorten-64-to-32]
        precision = field->length - (field->decimals > 0 ? 2 : 1);
                  ~ ~~~~~~~~~~~~~~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
生成1条警告。
编译statement.c
链接共享对象mysql2/mysql2.bundle
ld: 未找到库 'zstd'
clang: error: 链接器命令失败，退出代码为1 (使用-v查看调用详情)
make: *** [mysql2.bundle] 错误 1

make执行失败，退出代码2

Gem文件将保留在/Users/dorianmariefr/.asdf/installs/ruby/3.3.0/lib/ruby/gems/3.3.0/gems/mysql2-0.5.6供检查。
结果已记录到/Users/dorianmariefr/.asdf/installs/ruby/3.3.0/lib/ruby/gems/3.3.0/extensions/arm64-darwin-23/3.3.0/mysql2-0.5.6/gem_make.out

解决方案 #

1. 安装缺失的zstd库 #

MySQL 8.3依赖zstd压缩库，系统中未安装导致链接失败，通过Homebrew安装：

brew install zstd

2. 解决mysql_ssl_set隐式声明错误 #

该错误是因为mysql2 0.5.6版本与MySQL 8.3的头文件不兼容，有两种解决方式：

方案一：升级mysql2到兼容版本

mysql2 0.5.7及以上版本已修复对MySQL 8.3的支持，直接安装最新兼容版本：

gem install mysql2 --version ">= 0.5.7"

方案二：指定库路径继续使用0.5.6版本

如果必须使用0.5.6版本，安装时显式指定mysql_config和zstd库的路径：

gem install mysql2 -v 0.5.6 \
  --with-mysql-config=/opt/homebrew/bin/mysql_config \
  --with-zstd-dir=/opt/homebrew/opt/zstd

补充说明 #

Ruby 3.3.0默认启用C99标准，严格禁止隐式函数声明，而旧版mysql2在处理MySQL 8.3头文件时未正确声明mysql_ssl_set函数，升级mysql2版本是更彻底的解决方案。

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