bigdecimal gem 1.4.1/1.3.5编译失败求助：Ruby 3.1.2环境下如何解决？

错误原因 #

你遇到的编译失败核心是旧版本bigdecimal（1.3.5/1.4.1）与Ruby 3.1.2不兼容：

• Ruby 3.x对内部C API做了变更，比如rb_check_safe_obj函数被移除，替换为rb_check_safe_str，但旧版bigdecimal的代码仍在调用废弃的API
• Ruby 3.x的类型检查更严格，旧代码中64位转32位的整数转换会触发编译错误（此前仅为警告）

解决方案 #

方案1：使用Ruby内置的bigdecimal（推荐） #

Ruby 3.0及以上版本已经内置了bigdecimal库，无需单独安装旧版本。直接删除Gemfile中指定的bigdecimal版本约束，或移除该gem的显式声明，运行bundle install即可使用系统内置的兼容版本。

方案2：升级bigdecimal到兼容Ruby 3.x的版本 #

如果必须显式声明bigdecimal版本，选择支持Ruby 3.1的版本（如1.5.0及以上）。修改Gemfile中的版本号：

gem 'bigdecimal', '~> 1.5.0'

执行以下命令更新依赖：

bundle install

或直接单独安装兼容版本：

gem install bigdecimal -v '1.5.0'

方案3：降级Ruby版本到2.x系列 #

若项目依赖必须使用bigdecimal 1.3.5/1.4.1，只能降级Ruby到2.7.x或更早版本（这些版本与旧版bigdecimal的API完全兼容）。使用rbenv降级的示例命令：

# 安装Ruby 2.7.6（示例兼容版本）
rbenv install 2.7.6
# 切换当前项目使用该Ruby版本
rbenv local 2.7.6
# 重新安装项目依赖
bundle install

方案4：强制编译（不推荐，可能引发运行时问题） #

如果需要临时绕过编译错误，可通过添加编译参数禁用相关警告转错误，但此方法可能导致运行时不稳定，仅作应急使用：

gem install bigdecimal -v '1.3.5' -- --with-cflags="-Wno-error=implicit-function-declaration -Wno-error=shorten-64-to-32"

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