运行Rails控制台遇Fiddle gem报错：未初始化常量TYPE_UCHAR

问题场景 #

在以下环境执行rails c启动控制台时触发错误：

• 操作系统：macOS 12.6.5
• Ruby版本：3.1.4
• Rails版本：6.1.7.3

报错信息：

[WARNING] Could not load command "rails/commands/console/console_command". Error: uninitialized constant Fiddle::PackInfo::TYPE_UCHAR

TYPE_UCHAR  => ALIGN_CHAR,
  ^^^^^^^^^^

Did you mean? Fiddle::TYPE_CHAR.
/.rvm/gems/ruby-3.1.4/gems/fiddle-1.1.1/lib/fiddle/pack.rb:14:in `module:PackInfo'

已验证的临时修复 #

将Ruby版本降级至3.0.6后，错误消失，rails c可正常启动。

原因分析与其他修复方案 #

• 核心原因：Ruby 3.1.x自带的fiddle gem（版本1.1.1）与Rails 6.1.7.3存在兼容性冲突。Fiddle::PackInfo::TYPE_UCHAR常量在Ruby 3.1的fiddle实现中被调整，但Rails 6.1的依赖逻辑仍在调用该常量。
• 可选修复方向：
  • 升级fiddle gem到适配Ruby 3.1的版本：执行gem update fiddle后重新测试rails c
  • 升级Rails版本：将Rails升级到6.1分支的最新补丁版，或直接升级到Rails 7.x，后者对Ruby 3.1的支持更完善

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